Information.Err, méthode

Article
08/21/2007

Contient des informations sur les erreurs d'exécution.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function Err As ErrObject
'Utilisation
Dim returnValue As ErrObject

returnValue = Information.Err

public static ErrObject Err ()

public:
static ErrObject^ Err ()

public static ErrObject Err ()

public static function Err () : ErrObject

Valeur de retour

Contient des informations sur les erreurs d'exécution.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Err, objet (Visual Basic).

Les propriétés de l'objet Err sont définies par le générateur d'une erreur (Visual Basic, un objet ou le programmeur).

Lorsqu'une erreur d'exécution se produit, les propriétés de l'objet Err sont complétées par des informations qui identifient l'erreur de manière unique et que vous pouvez utiliser pour gérer l'erreur. Pour générer une erreur d'exécution dans votre code, utilisez la méthode Raise.

Les propriétés de l'objet Err sont réinitialisées à zéro ou à des chaînes de longueur nulle ("") après une instruction Exit Sub, Exit Function, Exit Property ou Resume Next dans une routine de gestion des erreurs. L'utilisation d'un formulaire de l'instruction Resume en dehors d'une routine de gestion des erreurs ne réinitialisera pas les propriétés de l'objet Err. Vous pouvez utiliser la méthode Clear pour réinitialiser explicitement Err.

Utilisez la méthode Raise plutôt que l'instruction Error pour générer des erreurs d'exécution pour les erreurs système et les modules de classe. L'utilisation de la méthode Raise dans un autre code dépend de la richesse des informations que vous souhaitez retourner.

L'objet Err est un objet intrinsèque avec une portée globale. Vous ne devez donc pas créer d'instance de cet objet dans votre code.

Exemple

Cet exemple utilise les propriétés de l'objet Err pour construire une boîte de dialogue de message d'erreur. Notez que si vous utilisez d'abord la méthode Clear, les valeurs par défaut de Visual Basic deviennent les propriétés de l'objet Raise lorsque vous générez une erreur Visual Basic avec la méthode Err.

Dim Msg As String
' If an error occurs, construct an error message.
On Error Resume Next   ' Defer error handling.
Err.Clear()
Err.Raise(6)   ' Generate an "Overflow" error.
' Check for error, then show message.
If Err.Number <> 0 Then
  Msg = "Error # " & Str(Err.Number) & " was generated by " _
      & Err.Source & ControlChars.CrLf & Err.Description
  MsgBox(Msg, MsgBoxStyle.Information, "Error")
End If

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Information, classe
Membres Information
Microsoft.VisualBasic, espace de noms

Autres ressources

Err, objet (Visual Basic)
Err, membres de l'objet
Error, instruction
On Error, instruction (Visual Basic)
Exit, instruction (Visual Basic)
Resume, instruction
Comment : obtenir des informations sur les erreurs d'exécution Visual Basic
Comment : extraire des informations à partir d'un objet Error

Partager via