FormErrorCollection.Add-Methode (XPathNavigator, String, String, String, Int32)
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 _
) 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 returnValue As FormError
returnValue = instance.Add(context, name, _
message, messageDetails, errorCode)
public abstract FormError Add(
XPathNavigator context,
string name,
string message,
string messageDetails,
int errorCode
)
Parameter
- context
Typ: System.Xml.XPath.XPathNavigator
Ein XPathNavigator-Objekt am Knoten, dem der Fehler zugeordnet wird.
- name
Typ: System.String
Der Name des Fehlers (kann nicht leer sein).
- message
Typ: System.String
Die Kurzmeldung für den Fehler.
- messageDetails
Typ: System.String
Die ausführliche Meldung für den Fehler.
- errorCode
Typ: System.Int32
Der Fehlercode des Fehlers.
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 nicht gültig. Die Parameter weisen beispielsweise 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 und Fehlernummer 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);
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)