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

Artikel
04/27/2010

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 _
) As FormError
'Usage
Dim instance As FormErrorCollection
Dim context As XPathNavigator
Dim name As String
Dim message As String
Dim messageDetails As String
Dim returnValue As FormError

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

public abstract FormError Add (
    XPathNavigator context,
    string name,
    string message,
    string messageDetails
)

Parameter

context
Ein XPathNavigator-Objekt am Knoten, dem der Fehler zugeordnet wird.

name
Der Name des Fehlers (kann nicht leer sein).

message
Die Kurzmeldung für den Fehler.

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

Rückgabewert

Ein Verweis auf das neue FormError-Objekt, das der Auflistung hinzugefügt wurde.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	name ist null oder eine leere Zeichenfolge.
ArgumentException	Ein Fehler desselben Namens ist bereits in der Auflistung vorhanden.
ArgumentNullException	Die an diese Methode übergebenen Parameter sind null.
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 Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Im folgenden Beispiel wird zunächst ein XPathNavigator-Objekt an dem Feld positioniert, dem ein Fehler zugeordnet werden soll. Dann werden XPathNavigator, Name, Meldung und detaillierte Meldung 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
Microsoft.Office.InfoPath-Namespace

Freigeben über