DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des Exceptions
  • Comment obtenir des informations sur l'erreur traitée ?
  • Exemple d'utilisation
  • Cas particulier
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
ErreurPropage (Fonction)
En anglais : ErrorPropagate
Propage une erreur non fatale qui pourra être traitée par le code appelant si ce code a activé une gestion des erreurs non fatales (sous l'éditeur de code, ou par la fonction ErreurChangeParamètre).
L'erreur est traitée par le niveau supérieur si :
  • le niveau supérieur a activé un traitement d'erreur.
  • l'erreur n'est pas gérée par un SI ... PAS ou par la variable ErreurDétectée.
Syntaxe

Propager une erreur non fatale (en ajoutant un message si nécessaire) Masquer les détails

ErreurPropage([<Message>])
<Message> : Chaîne de caractères optionnelle
Message supplémentaire pouvant être ajouté à l'erreur. Ce message est inséré au début de l'erreur.

Propager une erreur non fatale en modifiant le numéro de l'erreur (et en ajoutant un message si nécessaire) Masquer les détails

ErreurPropage(<Numéro> [, <Message>])
<Numéro> : Entier
Numéro de l'erreur, défini par le développeur. Ce numéro doit être compris entre 1 et 1000. Ce numéro remplace le numéro de l'erreur existant.
<Message> : Chaîne de caractères optionnelle
Message supplémentaire pouvant être ajouté à l'erreur. Ce message est inséré au début de l'erreur.
Remarques

Comment obtenir des informations sur l'erreur traitée ?

La fonction ErreurInfo permet de récupérer les informations de l'erreur.

Exemple d'utilisation

But : Encapsuler la fonction fOuvre dans une procédure tout en remontant l'erreur de la fonction fOuvre (si elle apparaît) :
PROCÉDURE OuvreFichier(LOCAL sNomFichier est une chaîne)
 
fOuvre(sNomFichier)
SI ErreurDétectée = Vrai ALORS
ErreurPropage()
RETOUR // ou RENVOYER
FIN
...
Il est ensuite possible d'appeler la procédure OuvreFichier :
...
OuvreFichier(sNomFichier)
SI ErreurDétectée = Vrai ALORS
// traitement de l'erreur
FIN
Note : Il est bien sûr possible de faire l'équivalent avec les modes automatiques de gestion des erreurs.

Cas particulier

Le mécanisme de traitement de l'erreur, qu'il soit automatique (géré par la fenêtre de gestion des erreurs) ou par programmation (fonction ErreurChangeParamètre) ne se déclenche pas si la fonction WLangage ou la procédure utilisateur se trouve dans un des cas suivants :
SI PAS <Fonction ou procédure> ALORS
// traitement de l'erreur
FIN
<Fonction ou procédure>
SI ErreurDétectée = Vrai ALORS
// traitement de l'erreur
FIN
Le mécanisme considère alors que l'erreur est traitée par programmation et ne déclenche pas le traitement automatique.
Classification Métier / UI : Code neutre
Composante : wd300vm.dll
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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