| Microsoft® Visual Basic® Scripting Edition Raise, méthode |
Référence du langage Version 1 |
Description
Génère une erreur d'exécution.
Syntaxe
object.Raise(number, source, description, helpfile, helpcontext)La méthode Raise comprend les éléments suivants :
Élément Description object Toujours l'objet Err. number Un sous-type entier Long qui identifie la nature de l'erreur. Les erreurs VBScript (tant définies par VBScript que par l'utilisateur) sont comprises dans la plage 0–65535. source Une expression de chaîne nommant l'objet ou l'application ayant initialement généré l'erreur. Lorsque vous définissez cette propriété pour un objet Automation, utilisez la forme project.class. Si rien n'est spécifié, l'identificateur de ressource du projet VBScript en cours est utilisé. description Une expression de chaîne décrivant l'erreur. Si elle n'est pas spécifiée, la valeur contenue dans l'argument number est examinée. Si elle peut être associée à un code d'erreur d'exécution VBScript, une chaîne fournie par VBScript est utilisée comme description. S'il n'existe aucune erreur VBScript correspondant à la valeur de l'argument number, un message d'erreur générique est utilisé. helpfile Le chemin d'accès complet du fichier d'aide contenant l'aide relative à cette erreur. Si cet argument n'est pas spécifié, VBScript utilise le lecteur, le chemin d'accès et le nom du fichier d'aide VBScript. helpcontext L'identificateur de contexte identifiant une rubrique contenue dans l'argument helpfile qui fournit l'aide correspondant à l'erreur. S'il est omis, l'identificateur de contexte du fichier d'aide VBScript pour l'erreur correspondant à la propriété number est utilisé, s'il existe.
Notes
Tous les arguments sont facultatifs à l'exception de number. Cependant, si vous utilisez la méthode Raise sans spécifier certains arguments et que les définitions des propriétés de l'objet Err contiennent des valeurs qui n'ont pas encore été supprimées, ces valeurs deviennent les valeurs de votre erreur.Lorsque vous définissez la propriété number pour votre propre code d'erreur dans un objet Automation, vous ajoutez le numéro de votre code d'erreur à la constante vbObjectError. Par exemple, pour générer le numéro d'erreur 1050, affectez vbObjectError + 1050 à la propriété number.
L'exemple ci-dessous illustre l'utilisation de la méthode Raise :
On Error Resume Next Err.Raise 6 ' Génére une erreur de dépassement. MsgBox ("Erreur N° " & CStr(Err.Number) & " " & Err.Description) Err.Clear ' Efface l'erreur.