PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Fenêtres des exceptions et des erreurs
  • Traitement des exceptions par programmation
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
dbgSauveDumpDébogage (Fonction)
En anglais : dbgSaveDebugDump
Sauve un dump de débogage de l'application. Un dump de débogage permet de repositionner "a posteriori" le débogueur sur les informations d'exécution de l'application au moment de l'appel de la fonction. Il est ainsi possible de voir la pile et le contenu des variables lors de l'ouverture du fichier de dump généré dans WINDEV, WEBDEV ou WINDEV Mobile.
Pour lire le dump de débogage, il suffit :
  • soit de faire un "Drag and Drop" du fichier ".wdump" vers l'éditeur de fenêtres ou de pages (par exemple sur la barre des documents ouverts).
  • soit directement d'ouvrir le fichier ".wdump" (option "Fichier .. Ouvrir").soit directement d'ouvrir le fichier ".wdump" (sous le volet "Accueil", dans l'onglet "Général", déroulez "Ouvrir" et sélectionnez "Ouvrir").
Remarques :
  • Pour lire le dump de débogage, le projet en cours sous l'éditeur doit être le projet de l'application ou le projet d'un des composants utilisé par l'application. Seules les informations concernant le projet en cours seront affichées.
  • Contrairement au dump mémoire, le dump de débogage permet de visualiser le contenu de la mémoire et des variables au moment de l'appel de la fonction.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Versions 24 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 24
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Exemple
// Sauve le dump de débogage dans l'audit d'exécution en cours
dbgSauveDumpDébogage()
// Sauve le dump de débogage dans un fichier
dbgSauveDumpDébogage(fRepExe() + ["\"] + "MonDump.wdump")
Syntaxe

Sauver le dump de débogage dans l'audit dynamique en cours

dbgSauveDumpDébogage()
Remarque : Cette syntaxe sauve le dump de débogage dans le fichier d'audit dynamique si l'audit est actif (fonction dbgActiveAudit). Si l'audit dynamique n'est pas actif, la fonction ne fait rien. L'audit peut être activé grâce à la fonction dbgActiveAudit.

Sauver le dump de débogage dans un fichier Masquer les détails

dbgSauveDumpDébogage(<Nom du fichier de dump>)
<Nom du fichier de dump> : Chaîne de caractères (avec guillemets)
Nom du fichier dans lequel est sauvé le dump. Le nom du fichier peut être construit avec les éléments suivants :
[%RepExe%]Répertoire de l'exécutable, toujours complété par le caractère "\". Ce répertoire est équivalent au résultat de la fonction fRepExe.
[%NomExe%]Nom de l'exécutable.
[%Date%]Date de lancement du dump de débogage (format AAAAMMJJ).
[%Heure%]Heure de lancement du dump débogage (format HHMMSS).
[%NomUtilisateur%]Nom de l'utilisateur courant.
[%NomMachine%]Nom de la machine.
Versions 18 et supérieures
[%RepDonnees%]
Nouveauté 18
[%RepDonnees%]
[%RepDonnees%]
Répertoire des fichiers de données HFSQL spécifié par l'utilisateur lors de l'installation de l'application. Ce répertoire est équivalent au résultat de la fonction fRepDonnées.
Versions 18 et supérieures
[%RepDonneesUtilisateur%]
Nouveauté 18
[%RepDonneesUtilisateur%]
[%RepDonneesUtilisateur%]
Répertoire pour les données de l'utilisateur courant de l'application courante. Ce répertoire est équivalent au résultat de la fonction fRepDonnéesUtilisateur.
Par défaut, si ce paramètre correspond à une chaîne vide ("") :
  • L'extension du fichier sera ".wdump".
  • avant la version 180062 : le nom du fichier créé correspond à : "[%RepExe%][%NomExe%]_[%Date%]_[%Heure%]".
    Par exemple : "C:\MonAppli\MonAppli_20091023_130812.wdump".
  • à partir de la version 180062 : le nom du fichier créé correspond à : "[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]".
    Par exemple : "C:\Users\Doc\AppData\Roaming\Applications WinDev\MonAppli\MonAppli_20091023_130812.wdump".
Par défaut, si ce paramètre correspond à une chaîne vide ("") :
  • L'extension du fichier sera ".wdump".
  • le nom du fichier créé correspond à : "[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]".
    Par exemple : "C:\Users\Doc\AppData\Roaming\Applications WinDev\MonAppli\MonAppli_20091023_130812.wdump".
Versions 22 et supérieures
Attention : Si vous utilisez la construction dynamique des chaînes (option "Autoriser "[% %]" dans les chaînes" dans l'onglet "Compilation" de la description du projet, une erreur de compilation apparaît (identificateur inconnu). Dans ce cas, il est nécessaire de faire précéder chaque chaîne par '-%'. Exemple :
dbgSauveDumpDébogage("[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
devient
dbgSauveDumpDébogage(-%"[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
Nouveauté 22
Attention : Si vous utilisez la construction dynamique des chaînes (option "Autoriser "[% %]" dans les chaînes" dans l'onglet "Compilation" de la description du projet, une erreur de compilation apparaît (identificateur inconnu). Dans ce cas, il est nécessaire de faire précéder chaque chaîne par '-%'. Exemple :
dbgSauveDumpDébogage("[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
devient
dbgSauveDumpDébogage(-%"[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
Attention : Si vous utilisez la construction dynamique des chaînes (option "Autoriser "[% %]" dans les chaînes" dans l'onglet "Compilation" de la description du projet, une erreur de compilation apparaît (identificateur inconnu). Dans ce cas, il est nécessaire de faire précéder chaque chaîne par '-%'. Exemple :
dbgSauveDumpDébogage("[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
devient
dbgSauveDumpDébogage(-%"[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
Remarques

Fenêtres des exceptions et des erreurs

Les fenêtres des exceptions et des erreurs proposent une option qui permet de sauver un dump de débogage au moment de l'exception ou de l'erreur. Il s'agit du lien :
"Enregistrer les informations pour le fournisseur de l'application (dump de débogage)"

Traitement des exceptions par programmation

La fonction dbgSauveDumpDébogage appelée depuis le code de traitement d'une exception sauve le dump de l'état au moment de l'exception et non pas le dump de l'état courant dans le traitement d'exception.
Pour sauver l'état au moment de l'exception, il est nécessaire d'appeler directement la fonction dbgSauveDumpDébogage depuis le traitement d'exception.
Si vous utilisez la fonction dbgSauveDumpDébogage depuis une procédure (ou méthode) appelée dans le traitement d'exception, l'état sauvé sera celui du traitement en cours : la pile ne correspondra plus à l'exception.
Composante : wd240vm.dll
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire