Errors.Add-Methode

Článek
04/27/2010

Fügt ein ErrorObject-Objekt zur ErrorsCollection-Auflistung hinzu und gibt einen Verweis auf das neue Error-Objekt zurück.

Diese Methode ist nicht CLS-kompatibel.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

'Declaration
<DispIdAttribute(2)> _
Function Add ( _
    varNode As Object, _
    bstrConditionName As String, _
    bstrShortErrorMessage As String, _
    bstrDetailedErrorMessage As String, _
    lErrorCode As Integer, _
    bstrType As String _
) As ErrorObject
'Usage
Dim instance As Errors
Dim varNode As Object
Dim bstrConditionName As String
Dim bstrShortErrorMessage As String
Dim bstrDetailedErrorMessage As String
Dim lErrorCode As Integer
Dim bstrType As String
Dim returnValue As ErrorObject

returnValue = instance.Add(varNode, bstrConditionName, bstrShortErrorMessage, bstrDetailedErrorMessage, lErrorCode, bstrType)

[DispIdAttribute(2)] 
ErrorObject Add (
    Object varNode,
    string bstrConditionName,
    string bstrShortErrorMessage,
    string bstrDetailedErrorMessage,
    int lErrorCode,
    string bstrType
)

Parameter

varNode
Der XML-Knoten, dem der Fehler zugeordnet wird.

bstrConditionName
Der Name des Fehlers.

bstrShortErrorMessage
Die Kurzmeldung für den Fehler.

bstrDetailedErrorMessage
Die ausführliche Meldung für den Fehler.

lErrorCode
Der Fehlercode des Fehlers.

bstrType
Der Standardwert ist "modeless". Der Typ der Fehlerverarbeitung. Der andere unterstützte Wert ist "modal".

Rückgabewert

Ein ErrorObject-Objekt, das das neu erstellte Error-Objekt darstellt.

Hinweise

Die Add-Methode wird verwendet, um benutzerdefinierte Fehlermeldungen in einem Microsoft Office InfoPath 2007-Formular zu erstellen. Mithilfe der Add-Methode können zwei Arten von Fehlern erstellt werden:

modeless	Der Benutzer wird mit einer eingebetteten Warnung über den Fehler informiert. Dann hat er die Möglichkeit, den Vorgang rückgängig zu machen und zum vorherigen Wert zurückzukehren.
modal	Der Benutzer wird mit einer Warnung im Hinweisdialogfeld über den Fehler informiert. Nachdem er in dem Dialogfeld auf OK geklickt hat, wird der Fehler als eingebettete Warnung angezeigt. Dann hat der Benutzer die Möglichkeit, den Vorgang rückgängig zu machen und zum vorherigen Wert zurückzukehren.

Hinweis:
Benutzerdefinierte Fehler können auch mit der ReportError-Methode erstellt werden.

Wichtig:
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Beispiel

//Add an error to the node
IXMLDOMDocument myDOM = thisXDocument.DOM;
IXMLDOMNode myNode = myDOM.selectSingleNode("my:myFields/my:aGroup/my:field1");
thisXDocument.Errors.Add(myNode,"condition","short","detail",102057,"modeless");

Siehe auch

Referenz

Errors-Schnittstelle
Errors-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Sdílet prostřednictvím