DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des Exceptions
  • 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/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
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.
Gestion automatique des exceptions

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.

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.

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
opFinProgrammeLa fonction ayant déclenché l'erreur renvoie une erreur et le programme s'arrête. Équivalent à la fonction FinProgramme.
opFinTraitementLa fonction ayant déclenché l'erreur renvoie une erreur et le traitement en cours s'arrête. Équivalent à la fonction DonneFocusEtRetourUtilisateur.
opRelanceProgrammeTermine l'application et relance automatiquement l'application.
Fonctions de gestion automatique des exceptions
ExceptionActiveRé-active le traitement d'exception en cours si l'exception a pu être corrigée.
ExceptionAfficheAffiche la fenêtre standard des exceptions avec le contenu de l'exception courante.
ExceptionChangeParamètreParamètre le comportement automatique à adopter en cas d'exception dans le traitement en cours.
ExceptionDéclencheDéclenche artificiellement le mécanisme de sécurité de WLangage en provoquant une exception.
ExceptionInfoRécupère des informations sur l'exception en cours.
ExceptionPropagePropage une exception.
ExceptionRestaureParamètreRé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

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale