FormErrorCollection-Klasse

Artikel
04/27/2010

Enthält ein FormError-Objekt für jeden Fehler im aktuellen Formular.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
<DefaultMemberAttribute("Item")> _
Public MustInherit Class FormErrorCollection
    Implements IEnumerable
'Usage
Dim instance As FormErrorCollection

[DefaultMemberAttribute("Item")] 
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

Beispiel

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)

Vererbungshierarchie

System.Object
Microsoft.Office.InfoPath.FormErrorCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

FormErrorCollection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über