Freigeben über

FormErrorCollection.Add-Methode (XPathNavigator, String, String, String, Int32, ErrorMode)

  • Artikel

Erstellt ein neues FormError-Objekt und fügt es dem dem aktuellen Formular zugeordneten FormErrorCollection-Objekt hinzu.

Namespace:  Microsoft.Office.InfoPath
Assembly:  Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

Syntax

'Declaration
Public MustOverride Function Add ( _
    context As XPathNavigator, _
    name As String, _
    message As String, _
    messageDetails As String, _
    errorCode As Integer, _
    errorMode As ErrorMode _
) As FormError
'Usage
Dim instance As FormErrorCollection
Dim context As XPathNavigator
Dim name As String
Dim message As String
Dim messageDetails As String
Dim errorCode As Integer
Dim errorMode As ErrorMode
Dim returnValue As FormError

returnValue = instance.Add(context, name, _
    message, messageDetails, errorCode, _
    errorMode)

public abstract FormError Add(
    XPathNavigator context,
    string name,
    string message,
    string messageDetails,
    int errorCode,
    ErrorMode errorMode
)

Parameter

  • name
    Typ: System.String
    Der Name des Fehlers (kann nicht leer sein).
  • messageDetails
    Typ: System.String
    Die ausführliche Meldung für den Fehler.

Rückgabewert

Typ: Microsoft.Office.InfoPath.FormError
Ein Verweis auf das neue FormError-Objekt, das der Auflistung hinzugefügt wurde.

Ausnahmen

Ausnahme Bedingung
ArgumentException

name ist ein Nullverweis (Nothing in Visual Basic) oder eine leere Zeichenfolge.
ArgumentException

Ein Fehler desselben Namens ist bereits in der Auflistung vorhanden.
ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein Nullverweis (Nothing in Visual Basic).
ArgumentException

Die an diese Methode übergebenen Parameter sind ungültig. Sie weisen z. B. den falschen Typ oder das falsche Format auf.

Hinweise

Die FormErrorType-Eigenschaft des neuen FormError-Objekts wird auf UserDefined festgelegt.

Hinweis

Es ist möglich, mehrere Fehler mit demselben name-Parameterwert verschiedenen context-Knoten hinzuzufügen. Wenn Sie jedoch einen Fehler mit demselben Namen einem context-Knoten zweimal hinzufügen, überschreibt der zweite hinzugefügte Fehler den ersten.

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.

Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler oder einem Webbrowser geöffnet wurden.

Beispiele

Im folgenden Beispiel wird zunächst ein XPathNavigator-Objekt an dem Feld positioniert, dem ein Fehler zugeordnet werden soll. Dann werden XPathNavigator, Name, Meldung, detaillierte Meldung, Fehlercode, Fehlernummer und Fehleranzeigemodus an die Add-Methode der FormErrorCollection-Klasse übergeben, um den Fehler der Fehlerauflistung des Formulars hinzuzufügen.

XPathNavigator root, txtbox;
// Create XPathNavigator for main data source.
root = this.MainDataSource.CreateNavigator();

// Create XPathNavigator positioned at field to associate with error.
txtbox = root.SelectSingleNode("//my:field1", this.NamespaceManager);

// Get form's collection of errors and add error.
this.Errors.Add(txtbox, "Field1Error", "Short error message.", 
   "Detailed error description.", 102057, ErrorMode.Modeless);

Dim root, txtbox As XPathNavigator
' Create XPathNavigator for main data source.
root = Me.MainDataSource.CreateNavigator()

' Create XPathNavigator positioned at field to add error.
txtbox = root.SelectSingleNode("//my:field1", Me.NamespaceManager)

' Get form's collection of errors and add error.
Me.Errors.Add(txtbox, "Field1Error", "Short error message.", 
   "Detailed error description.", 102057, ErrorMode.Modeless)

Siehe auch

Referenz

FormErrorCollection Klasse

FormErrorCollection-Member

Add Überladung

Microsoft.Office.InfoPath-Namespace