Méthode Raise

Article
04/07/2023

Syntaxe

objet . Numéro d’augmentation,source, description, fichier d’aide, helpcontext

La méthode Raise comprend le qualificateur d'objet et les arguments nommés suivants :

Argument	Description
object	Obligatoire. Toujours l’objet Err .
number	Obligatoire. Entier long qui identifie la nature de l'erreur. Les erreurs Visual Basic (erreurs définies par Visual Basic et par l'utilisateur) sont comprises entre 0 et 65 535. La plage comprise entre 0 et 512 est réservée aux erreurs système et la plage comprise entre 513 et 65 535 est disponible pour les erreurs définies par l'utilisateur. Lorsque vous définissez la propriété Number sur votre propre code d’erreur dans un module de classe, vous ajoutez votre numéro de code d’erreur à la constantevbObjectError. Par exemple, pour générer le numéro d'erreur 513, affectez vbObjectError + 513 à la propriété Number.
source	Optional. Expression de chaîne qui nomme l'objet ou l'application ayant généré l'erreur. Lorsque vous définissez la propriété Source pour un objet, utilisez le formulaire project.class. Si source n'est pas spécifié, l'ID programmatique du projet Visual Basic actuel est utilisé.
description	Optional. Expression de chaîne qui décrit l'erreur. Si aucune valeur n'est spécifiée, la valeur de Number est examinée. S’il peut être mappé à un code d’erreur d’exécution Visual Basic, la chaîne retournée par la fonction Error est utilisée comme Description. S'il n'existe aucune erreur Visual Basic correspondant à Number, le message « Erreur définie par l'application ou par l'objet » est utilisé.
helpfile	Facultatif. Chemin d'accès complet au fichier d'aide qui contient de l'aide sur cette erreur. S'il n'est pas spécifié, Visual Basic utilise le nom complet du lecteur, du chemin d'accès et du fichier d'aide Visual Basic. Consultez HelpFile.
helpcontext	Optional. ID de contexte identifiant une rubrique dans le fichier d'aide qui contient de l'aide sur l'erreur. S'il est omis, l'ID de contexte du fichier d'aide Visual Basic de l'erreur correspondant à la propriété Number est utilisé, s'il existe. Consultez HelpContext.

Remarques

Tous les arguments sont facultatifs, sauf number. Si vous utilisez la méthode Raise sans spécifier d'arguments et que les paramètres de propriété de l'objet Err contiennent des valeurs qui n'ont pas été effacées, ces valeurs représentent celles de votre erreur.

Raise est utilisé pour générer des erreurs d’exécution et peut être utilisé à la place de l’instruction Error .

La méthode Raise est utile pour générer des erreurs lors de la création de modules de classe, car l'objet Err transmet des informations plus détaillées que si vous générez des erreurs avec l'instruction Error. Par exemple, grâce à la méthode Raise, la source ayant généré l'erreur peut être spécifiée dans la propriété Source, l'aide en ligne correspondant à l'erreur peut être référencée, etc.

Exemple

Cet exemple utilise la méthode Raise de l'objet Err pour générer une erreur dans un objet Automation écrit dans Visual Basic. Il a l’ID MyProj.MyObjectde programmation . Sur MacIntosh, le nom du lecteur par défaut est « HD » et les portions du nom de chemin d’accès sont séparées par des points-virgules au lieu de barres obliques inverses.

Const MyContextID = 1010407    ' Define a constant for contextID.
Function TestName(CurrentName, NewName)
    If Instr(NewName, "bob") Then    ' Test the validity of NewName.
        ' Raise the exception
        Err.Raise vbObjectError + 513, "MyProj.MyObject", _
        "No ""bob"" allowed in your name", "c:\MyProj\MyHelp.Hlp", _
        MyContextID
    End If
End Function

Voir aussi

Objets (Visual Basic pour Applications)

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.

Partager via