PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Gestion automatique des exceptions
  • Mettre en place la gestion automatique des exceptions
  • Exécuter le traitement d'erreur ("CAS EXCEPTION:" dans le code)
  • Exécuter une procédure de traitement d'exception :
  • Fonctions de gestion automatique des exceptions
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
Présentation
La gestion des exceptions peut être personnalisée par traitement.
Vous pouvez choisir d'utiliser un traitement automatique d'exception ou opter pour une gestion avancée grâce à différentes fonctions WLangage.
Important : La gestion automatique des erreurs et des exceptions fonctionne uniquement pour le traitement pour lequel elle est définie. Pour utiliser un traitement global et unique en cas d'exception, il faut utiliser le mécanisme des exceptions générales.
AndroidJava Attention : Le mécanisme des exceptions générales n'est pas disponible. Seules les exceptions spécifiques (QUAND EXCEPTION DANS) sont disponibles.
Versions 19 et supérieures
WEBDEV - Code Navigateur Le traitement automatique d'exception est désormais disponible en code Navigateur.
WEBDEV - Code Navigateur Le traitement automatique d'exception permet de gérer les erreurs du WLangage. Les erreurs présentes dans les fichiers Javascript externes ne sont pas gérées.
Nouveauté 19
WEBDEV - Code Navigateur Le traitement automatique d'exception est désormais disponible en code Navigateur.
WEBDEV - Code Navigateur Le traitement automatique d'exception permet de gérer les erreurs du WLangage. Les erreurs présentes dans les fichiers Javascript externes ne sont pas gérées.
WEBDEV - Code Navigateur Le traitement automatique d'exception est désormais disponible en code Navigateur.
WEBDEV - Code Navigateur Le traitement automatique d'exception permet de gérer les erreurs du WLangage. Les erreurs présentes dans les fichiers Javascript externes ne sont pas gérées.
Gestion automatique des exceptions
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurEtats et RequêtesWindowsAndroidiPhone/iPadWindows MobileJava

Mettre en place la gestion automatique des exceptions

Pour mettre en place la gestion automatique des exceptions :
  1. Affichez sous l'éditeur de code, le traitement dans lequel les exceptions doivent être traitées : code d'initialisation, code de clic, procédure, ...
  2. Dans l'entête du code, cliquez sur "Quand exception : par programme".
  3. La fenêtre qui s'affiche permet de spécifier le type de traitement automatique à effectuer :
Une gestion avancée des erreurs peut être réalisée grâce à la fonction ExceptionChangeParamètre.
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurEtats et RequêtesWindowsAndroidiPhone/iPadWindows MobileJava

Exécuter le traitement d'erreur ("CAS EXCEPTION:" dans le code)

Si cette option est sélectionnée, une ligne de code est ajoutée dans le code en cours "CAS EXCEPTION:". Les lignes de code suivant cette étiquette seront exécutées lorsqu'une exception sera rencontrée dans les lignes de code précédentes (ou dans un traitement appelé par ces lignes de code).
Par exemple :
CAS EXCEPTION:
// Affichage d'un message d'erreur
Erreur("Une erreur fatale a été détectée.", ExceptionInfo(), "", "Arrêt de la procédure.")
// Gestion de cette erreur
...
Cette option est conseillée pour regrouper par exemple tous les traitements d'exception pouvant survenir.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsAndroidiPhone/iPadWindows MobileJava

Exécuter une procédure de traitement d'exception :

Si cette option est sélectionnée, lorsqu'une exception sera rencontrée dans le traitement en cours (ou dans les traitements appelés par le traitement en cours), la procédure indiquée sera automatiquement exécutée pour traiter l'erreur. Cette option est conseillée si vous possédez dans votre application une procédure existante traitant les exceptions. L'appel à cette procédure sera automatique dès qu'une exception est rencontrée. Aucun test à faire.
Dans cette procédure, il est possible de renvoyer une des constantes présentées dans le tableau ci-dessous.
En fonction de la constante renvoyée, WINDEV, WEBDEV ou WINDEV Mobile effectuera le traitement correspondant.
opAnnulerRelance l'exception
opFinTraitementLa fonction ayant déclenché l'erreur renvoie une erreur et le traitement en cours s'arrête. Équivalent à RepriseSaisie
opFinProgrammeLa fonction ayant déclenché l'erreur renvoie une erreur et le programme s'arrête. Équivalent à FinProgramme
opRelanceProgrammeTermine l'application et relance automatiquement l'application.
AndroidJava Cette constante n'est pas disponible en Java.
Fonctions de gestion automatique des exceptions
Versions 09 et supérieures
ExceptionActive
Nouveauté 09
ExceptionActive
ExceptionActive
Ré-active le traitement d'exception en cours si l'exception a pu être corrigée.
Versions 16 et supérieures
ExceptionAffiche
Nouveauté 16
ExceptionAffiche
ExceptionAffiche
Affiche la fenêtre standard des exceptions avec le contenu de l'exception courante.
Versions 10 et supérieures
ExceptionChangeParamètre
ExceptionChangeParamètre
Paramètre le comportement automatique à adopter en cas d'exception dans le traitement en cours.
Versions 09 et supérieures
ExceptionDéclenche
Nouveauté 09
ExceptionDéclenche
ExceptionDéclenche
Déclenche artificiellement le mécanisme de sécurité de WLangage en provoquant une exception.
Versions 09 et supérieures
ExceptionInfo
Nouveauté 09
ExceptionInfo
ExceptionInfo
Récupère des informations sur l'exception en cours.
Versions 10 et supérieures
ExceptionPropage
Nouveauté 10
ExceptionPropage
ExceptionPropage
Propage une exception.
Versions 10 et supérieures
ExceptionRestaureParamètre
ExceptionRestaureParamètre
Rétablit le traitement d'exception d'un traitement.
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Personnalisation de la fenêtre des exceptions
Il manque ces informations dans cette page :

Personnalisation de la fenêtre des exceptions

Par défaut, les fenêtres de gestion des erreurs, des exceptions et des assertions sont intégrées à l'application. Ces fenêtres sont disponibles en français et en anglais.
Pour personnaliser ces fenêtres (ou pour les traduire dans une autre langue), il suffit d'importer les fenêtres correspondantes dans votre projet.
1. Dans le ruban :
Sous le volet "Projet", dans le groupe "Projet", déroulez "Importer" et sélectionnez "Des éléments WinDev et leurs dépendances".
2. Sélectionnez le répertoire des éléments à importer : "Programmes\Donnees\Fenêtres prédéfinies\Assertion - Erreur - Exception".
3. Sélectionnez les fenêtres à importer :
WinDev WinDev Mobile Type de fenêtre
WD_AfficheAssertion.wdw WM_AfficheAssertion.WPW Fenêtre de gestion des assertions
WD_AfficheErreur.wdw WM_AfficheErreur.WPW Fenêtre de gestion des erreurs
WD_AfficheException.wdw WM_AfficheException.WPW Fenêtre de gestion des exceptions
WD_ModeleErreur.wdt Modèle utilisé par les fenêtres WinDev.
4. Validez. La ou les fenêtres sont intégrées à votre projet. Ces fenêtres seront automatiquement utilisées et remplaceront les fenêtres par défaut.
Remarque : Pour utiliser les fenêtres par défaut, il suffit de supprimer les fenêtres importées de votre projet.
jjmonot
06 nov. 2013