Raise-Methode

Artikel
04/07/2023

Syntax

-Objekt.Raisenumber, source, description, helpfile, helpcontext

Die Raise-Methode weist den folgenden Objektbezeichner und die folgenden benannten Argumente auf:

Argument	Beschreibung
Objekt	Erforderlich. Immer das Err-Objekt .
number	Erforderlich. Lange ganze Zahl, die die Art des Fehlers angibt. Visual Basic-Fehler (sowohl von Visual Basic definierte als auch benutzerdefinierte Fehler) liegen im Bereich 0–65535. Der Bereich 0–512 ist für Systemfehler reserviert. Der Bereich 513–65535 ist für benutzerdefinierte Fehler verfügbar. Wenn Sie die Number-Eigenschaft auf Ihren eigenen Fehlercode in einem Klassenmodul festlegen, fügen Sie die Fehlercodenummer zur VbObjectError-Konstante hinzu. Um beispielsweise die Fehlernummer 513 zu generieren, weisen Sie vbObjectError + 513 der Number-Eigenschaft zu.
source	Optional. Zeichenfolgenausdruck , der das Objekt oder die Anwendung benennt, das bzw. die den Fehler generiert hat. Verwenden Sie beim Festlegen der Source-Eigenschaft für ein Objekt das Formular project.class. Wenn source nicht angegeben ist, wird die programmgesteuerte ID des aktuellen Visual Basic-Projekts verwendet.
description	Optional. Zeichenfolgenausdruck zur Beschreibung des Fehlers. Wenn nicht angegeben, wird der Wert in Number überprüft. Wenn sie einem Visual Basic-Laufzeitfehlercode zugeordnet werden kann, wird die von der Error-Funktion zurückgegebene Zeichenfolge als Beschreibung verwendet. Wenn kein entsprechender Visual Basic-Fehler für Number verfügbar ist, wird die Meldung "Anwendungs- oder objektbedingter Fehler verwendet.
helpfile	Optional. Der vollqualifizierte Pfad zur Hilfedatei, in der Hilfe zu diesem Fehler gefunden werden kann. Wenn nicht angegeben, wird von Visual Basic der vollqualifizierte Laufwerks-, Pfad- und Dateiname der Visual Basic-Hilfedatei verwendet. Weitere Informationen finden Sie unter HelpFile.
Helpcontext	Optional. Die Kontext-ID, mit der ein Thema in helpfile angegeben wird, in der Hilfe zu diesem Fehler bereitgestellt wird. Wenn nicht angegeben, wird (sofern vorhanden) die Kontext-ID der Visual Basic-Hilfedatei für den Fehler verwendet, der der Number-Eigenschaft entspricht. Weitere Informationen finden Sie unter HelpContext.

HinwBemerkungeneise

Alle Argumente mit Ausnahme von number sind optional. Wenn Sie Raise ohne die Angabe von Argumenten verwenden und die Eigenschafteneinstellungen für das Err -Objekt Werte enthalten, die nicht gelöscht wurden, werden diese Werte als Werte für Ihren Fehler verwendet.

Raise wird zum Generieren von Laufzeitfehlern verwendet und kann anstelle der Error-Anweisung verwendet werden.

Raise ist hilfreich für das Erzeugen von Fehlern beim Schreiben von Klassenmodulen, da mit dem Err -Objekt umfassendere Informationen bereitgestellt werden können, als dies beim Erzeugen von Fehlern mit der Error -Anweisung möglich ist. Sie können beispielsweise mit der Raise-Methode mithilfe der Source-Eigenschaft die Quelle angeben, die den Fehler erzeugt hat, es kann online auf Hilfe zu dem Fehler verwiesen werden usw.

Beispiel

In diesem Beispiel wird die Raise-Methode des Err-Objekts verwendet, um einen Fehler in einem Automation-Objekt zu generieren, das in Visual Basic geschrieben wurde. Sie weist die programmgesteuerte ID MyProj.MyObjectauf. Auf einem Macintosh-Computer ist „HD“ der Standardlaufwerkname, und Teile des Pfadnamens werden durch Doppelpunkte statt umgekehrte Schrägstriche getrennt.

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

Siehe auch

Objekte (Visual Basic for Applications)

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.