L'objet Err constitue la solution de gestion des erreurs d'exécutions ou de syntaxes d'un programme VBScript.
Les propriétés
L'objet Err contient cinq informations, le numéro, la description et la source de l'erreur ainsi qu'un identificateur contextuel et une adresse d'un fichier d'aide.
Ces informations sont accessibles à partir des cinq propriétés citées ci-dessous.
Propriété |
Description |
Err.Number |
donne le numéro de l'erreur. |
Err.Description |
donne le message d'erreur. |
Err.Source |
donne le nom du composant responsable de l'erreur. |
Err.HelpContext[=contextID] |
définit ou retourne un identificateur de contexte pour une rubrique dans un fichier d'aide. |
Err.HelpFile[=contextID] |
définit ou retourne le chemin complet d'un fichier d'aide. |
Les méthodes
Deux méthodes permettent soit de générer une erreur sciemment, soit d'effacer les propriétés de l'objet Err.
Propriété |
Description |
Err.Clear |
réinitialise le gestionnaire d'erreur. |
Err.Raise(Numéro, Source, Description, Fichier_Aide, Contexte_Aide) |
génére une erreur.
Paramètre |
Description |
Numéro |
Nombre entier représentant le numéro d'identification de l'erreur. |
Source |
Chaîne de caractères représentant l'élément du script ayant provoqué l'erreur. |
Description |
Chaîne de caractères représentant le message d'erreur. |
Fichier_Aide |
URL (Uniform Resource Locator) pointant le fichier d'aide associé à l'erreur. |
Contexte_Aide |
Identificateur contextuel pointant une rubrique dans le fichier d'aide spécifié ci-dessus. |
|
Exemple : [voir]
<-- Fichier érroné -->
<!--#include file="identiferr.asp" -->
<html>
<head>
<title>Démonstration de Err</title>
</head>
<body>
<%
On Error Resume Next
Response.Write 100 / 0
HandleError("Division par zéro ! Ligne 9")
%>
<-- Fichier inclus identiferr.asp -->
<%
Sub HandleError(sourceErreur)
If Err.Number = 0 Then Exit Sub
%>
<h3>--> Une erreur a été détectée ! <--</h3>
<DL>
<DT><U>Numéro :</u></dt>
<DD><% = Err.Number %></dd>
<DT><U>Description :</u></dt>
<DD><% = Err.Description %></dd>
<DT><U>Source :</u></dt>
<DD><% = Err.Source %></dd>
<DT><U>Fichier concernée :</u></dt>
<DD><% = Request.ServerVariables("PATH_TRANSLATED") %></dd>
<DT><U>Adresse du fichier :</u></dt>
<DD><% = Request.ServerVariables("URL") %></dd>
<DT><U>Localisation :</u></dt>
<DD><% = sourceErreur %></dd>
</dl>
</body>
</html>
<%
Response.End
End Sub
%> |