ErrorToString-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt die Fehlermeldung zurück, die der jeweiligen Fehlernummer entspricht.

Public Shared Function ErrorToString(ByVal ErrorNumber As Integer) As String

Parameter

ErrorNumber
Optional. Beliebige gültige Fehlernummer.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	ErrorNumber liegt außerhalb des Bereichs.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Die ErrorToString-Funktion prüft die Eigenschafteneinstellungen des Err-Objekts, um den zuletzt aufgetretenen Laufzeitfehler zu identifizieren. Der Rückgabewert der ErrorToString-Funktion entspricht der Description-Eigenschaft des Err-Objekts. Wenn ErrorNumber eine gültige, aber nicht definierte Fehlernummer ist, gibt ErrorToString die Zeichenfolge "Application-defined or object-defined error." zurück. Wenn ErrorNumber ungültig ist, tritt ein Fehler auf. Wenn ErrorNumber übergangen wird, wird die Meldung zurückgegeben, die dem letzten Laufzeitfehler entspricht. Falls kein Laufzeitfehler aufgetreten oder ErrorNumber gleich 0 (null) ist, gibt ErrorToString eine Zeichenfolge mit der Länge 0 (null, "") zurück.

In Visual Basic 6.0 und früheren Versionen wurde diese Funktionalität durch die Error-Funktion bereitgestellt.

Beispiel

Im folgenden Code wird die ErrorToString-Funktion zum Anzeigen von Fehlermeldungen verwendet, die den angegebenen Fehlernummern entsprechen.

Dim ErrorNumber As Integer
For ErrorNumber = 61 To 64   ' Loop through values 61 - 64.
   MsgBox(ErrorToString(ErrorNumber))   ' Display error names in message box.
Next ErrorNumber