FormErrorCollection-Klasse
Enthält ein FormError-Objekt für jeden Fehler im aktuellen Formular.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.FormErrorCollection
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class FormErrorCollection _
Implements IEnumerable
'Usage
Dim instance As FormErrorCollection
public abstract class FormErrorCollection : IEnumerable
Hinweise
Ein FormErrorCollection-Objekt enthält eine Auflistung von FormError-Objekten, die alle Fehler darstellen, die im zugeordneten Formular auftreten. Die Auflistung von Fehlern umfasst Validierungsfehler, durch das System generierte Fehler und benutzerdefinierte Fehler. Die FormErrorCollection-Klasse stellt Eigenschaften und Methoden bereit, um die darin enthaltenen FormError-Objekte hinzuzufügen, zu löschen oder darauf zuzugreifen. Sie können Validierungsfehler oder durch das System generierte Fehler nicht aus dieser Auflistung löschen.
Zusätzlich zur Verwaltung der von InfoPath generierten Fehler kann die FormErrorCollection-Klasse auch verwendet werden, um mithilfe der Add-Methode benutzerdefinierte Fehler zu erstellen.
Hinweis
Benutzerdefinierte Fehler können auch mithilfe der ReportError-Methode der XmlValidatingEventArgs-Klasse erstellt werden.
Verwenden Sie zum Zugreifen auf das einem Formular zugeordnete FormErrorCollection-Objekt die Errors-Eigenschaft der XmlForm-Klasse.
FormErrorCollection myErrors = this.Errors;
Dim myErrors As FormErrorCollection = Me.Errors
Beispiele
Im folgenden Beispiel wird zunächst ein XPathNavigator-Objekt an dem Feld positioniert, dem ein Fehler zugeordnet werden soll. Dann werden XPathNavigator und Fehlermeldungsdetails 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)
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.