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.
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.
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