FormErrorCollection.Add Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Add(XPathNavigator, String, String) |
Erstellt ein neues FormError -Objekt, das dem FormErrorCollection aktuellen Formular zugeordnet ist, und fügt es hinzu. |
| Add(XPathNavigator, String, String, String) |
Erstellt ein neues FormError -Objekt, das dem FormErrorCollection aktuellen Formular zugeordnet ist, und fügt es hinzu. |
| Add(XPathNavigator, String, String, String, Int32) |
Erstellt ein neues FormError -Objekt, das dem FormErrorCollection aktuellen Formular zugeordnet ist, und fügt es hinzu. |
| Add(XPathNavigator, String, String, String, Int32, ErrorMode) |
Erstellt ein neues FormError -Objekt, das dem FormErrorCollection aktuellen Formular zugeordnet ist, und fügt es hinzu. |
Add(XPathNavigator, String, String)
Erstellt ein neues FormError -Objekt, das dem FormErrorCollection aktuellen Formular zugeordnet ist, und fügt es hinzu.
public:
abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message);public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message);abstract member Add : System.Xml.XPath.XPathNavigator * string * string -> Microsoft.Office.InfoPath.FormErrorPublic MustOverride Function Add (context As XPathNavigator, name As String, message As String) As FormErrorParameter
- context
- XPathNavigator
Ein XPathNavigator Objekt, das auf dem Knoten positioniert ist, dem der Fehler zugeordnet wird.
- name
- String
Der Name des Fehlers (kann nicht leer sein).
- message
- String
Die Kurzmeldung für den Fehler.
Gibt zurück
Ein Verweis auf das neue FormError , das der Auflistung hinzugefügt wurde.
Ausnahmen
Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).
Die an diese Methode übergebenen Parameter sind nicht gültig. Die Parameter weisen beispielsweise den falschen Typ oder das falsche Format auf.
Beispiele
Im folgenden Beispiel wird zunächst ein XPathNavigator-Objekt an dem Feld positioniert, dem ein Fehler zugeordnet werden soll. Anschließend werden der XPathNavigator, der Name und die 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.");
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.")
Hinweise
Der FormErrorType des neuen FormError-Fehlers wird auf UserDefinedfestgelegt.
Hinweis: Es ist möglich, mehrere Fehler mit demselben name Parameterwert zu verschiedenen context Knoten hinzuzufügen. Wenn Sie demselben context Knoten jedoch zweimal einen Fehler mit demselben Namen hinzufügen, überschreibt der zweite hinzugefügte Fehler den ersten.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.
Gilt für:
Add(XPathNavigator, String, String, String)
Erstellt ein neues FormError -Objekt, das dem FormErrorCollection aktuellen Formular zugeordnet ist, und fügt es hinzu.
public:
abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails);public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails);abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string -> Microsoft.Office.InfoPath.FormErrorPublic MustOverride Function Add (context As XPathNavigator, name As String, message As String, messageDetails As String) As FormErrorParameter
- context
- XPathNavigator
Ein XPathNavigator Objekt, das auf dem Knoten positioniert ist, dem der Fehler zugeordnet wird.
- name
- String
Der Name des Fehlers (kann nicht leer sein).
- message
- String
Die Kurzmeldung für den Fehler.
- messageDetails
- String
Die ausführliche Meldung für den Fehler.
Gibt zurück
Ein Verweis auf das neue FormError , das der Auflistung hinzugefügt wurde.
Ausnahmen
Die an diese Methode übergebenen Parameter sind nicht gültig. Die Parameter weisen beispielsweise den falschen Typ oder das falsche Format auf.
Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).
Beispiele
Im folgenden Beispiel wird zunächst ein XPathNavigator-Objekt an dem Feld positioniert, dem ein Fehler zugeordnet werden soll. Anschließend werden der XPathNavigator, der Name, die Nachricht und die ausführliche Nachricht 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)
Hinweise
Der FormErrorType des neuen FormError-Fehlers wird auf UserDefinedfestgelegt.
Hinweis: Es ist möglich, mehrere Fehler mit demselben name Parameterwert zu verschiedenen context Knoten hinzuzufügen. Wenn Sie demselben context Knoten jedoch zweimal einen Fehler mit demselben Namen hinzufügen, überschreibt der zweite hinzugefügte Fehler den ersten.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.
Gilt für:
Add(XPathNavigator, String, String, String, Int32)
Erstellt ein neues FormError -Objekt, das dem FormErrorCollection aktuellen Formular zugeordnet ist, und fügt es hinzu.
public:
abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails, int errorCode);public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails, int errorCode);abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string * int -> Microsoft.Office.InfoPath.FormErrorPublic MustOverride Function Add (context As XPathNavigator, name As String, message As String, messageDetails As String, errorCode As Integer) As FormErrorParameter
- context
- XPathNavigator
Ein XPathNavigator Objekt, das auf dem Knoten positioniert ist, dem der Fehler zugeordnet wird.
- name
- String
Der Name des Fehlers (kann nicht leer sein).
- message
- String
Die Kurzmeldung für den Fehler.
- messageDetails
- String
Die ausführliche Meldung für den Fehler.
- errorCode
- Int32
Der Fehlercode des Fehlers.
Gibt zurück
Ein Verweis auf das neue FormError , das der Auflistung hinzugefügt wurde.
Ausnahmen
Die an diese Methode übergebenen Parameter sind nicht gültig. Die Parameter weisen beispielsweise den falschen Typ oder das falsche Format auf.
Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).
Beispiele
Im folgenden Beispiel wird zunächst ein XPathNavigator-Objekt an dem Feld positioniert, dem ein Fehler zugeordnet werden soll. Anschließend werden der XPathNavigator, der Name, die Nachricht, die detaillierte Meldung, der Fehlercode und die 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)
Hinweise
Der FormErrorType des neuen FormError-Fehlers wird auf UserDefinedfestgelegt.
Hinweis: Es ist möglich, mehrere Fehler mit demselben name Parameterwert zu verschiedenen context Knoten hinzuzufügen. Wenn Sie demselben context Knoten jedoch zweimal einen Fehler mit demselben Namen hinzufügen, überschreibt der zweite hinzugefügte Fehler den ersten.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.
Gilt für:
Add(XPathNavigator, String, String, String, Int32, ErrorMode)
Erstellt ein neues FormError -Objekt, das dem FormErrorCollection aktuellen Formular zugeordnet ist, und fügt es hinzu.
public:
abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails, int errorCode, Microsoft::Office::InfoPath::ErrorMode errorMode);public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails, int errorCode, Microsoft.Office.InfoPath.ErrorMode errorMode);abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string * int * Microsoft.Office.InfoPath.ErrorMode -> Microsoft.Office.InfoPath.FormErrorParameter
- context
- XPathNavigator
Ein XPathNavigator Objekt, das auf dem Knoten positioniert ist, dem der Fehler zugeordnet wird.
- name
- String
Der Name des Fehlers (kann nicht leer sein).
- message
- String
Die Kurzmeldung für den Fehler.
- messageDetails
- String
Die ausführliche Meldung für den Fehler.
- errorCode
- Int32
Der Fehlercode des Fehlers.
Gibt zurück
Ein Verweis auf das neue FormError , das der Auflistung hinzugefügt wurde.
Ausnahmen
Die an diese Methode übergebenen Parameter sind ungültig. Die Parameter weisen beispielsweise den falschen Typ oder das falsche Format auf.
Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).
Beispiele
Im folgenden Beispiel wird zunächst ein XPathNavigator-Objekt an dem Feld positioniert, dem ein Fehler zugeordnet werden soll. Anschließend werden der XPathNavigator, der Name, die Meldung, die detaillierte Meldung, der Fehlercode, die Fehlernummer und der 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)
Hinweise
Der FormErrorType des neuen FormError-Fehlers wird auf UserDefinedfestgelegt.
Hinweis: Es ist möglich, mehrere Fehler mit demselben name Parameterwert zu verschiedenen context Knoten hinzuzufügen. Wenn Sie demselben context Knoten jedoch zweimal einen Fehler mit demselben Namen hinzufügen, überschreibt der zweite hinzugefügte Fehler den ersten.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.