FormErrorCollection Klasse

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

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.

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

public ref class FormErrorCollection abstract : System::Collections::IEnumerable

public abstract class FormErrorCollection : System.Collections.IEnumerable

type FormErrorCollection = class
    interface IEnumerable

Public MustInherit Class FormErrorCollection
Implements IEnumerable

Vererbung: Object
FormErrorCollection

Implementiert: IEnumerable

Beispiele

Im folgenden Beispiel wird zunächst ein XPathNavigator-Objekt an dem Feld positioniert, dem ein Fehler zugeordnet werden soll. Anschließend werden die 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)

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 benutzerdefinierte Fehler mithilfe der Add -Methode zu erstellen.

Hinweis: Benutzerdefinierte Fehler können auch mit der ReportError -Methode der XmlValidatingEventArgs -Klasse erstellt werden.

Um auf das Einem Formular zugeordnete FormErrorCollection-Objekt zuzugreifen, verwenden Sie die Errors -Eigenschaft der XmlForm -Klasse.

FormErrorCollection myErrors = this.Errors; Dim myErrors As FormErrorCollection = Me.Errors

Konstruktoren

FormErrorCollection()

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

Eigenschaften

Count	Ruft die Anzahl der FormError Objekte im -Objekt ab, das FormErrorCollection dem aktuellen Formular zugeordnet ist.
Item[Int32]	Ruft ein FormError -Objekt aus dem FormErrorCollection -Objekt ab, das dem aktuellen Formular nach Indexwert zugeordnet ist.

Methoden

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, String, Int32)	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)	Erstellt ein neues FormError -Objekt, das dem FormErrorCollection aktuellen Formular zugeordnet ist, und fügt es hinzu.
Delete(FormError)	Löscht das angegebene FormError aus dem -Objekt, das FormErrorCollection dem aktuellen Formular zugeordnet ist.
Delete(String)	Löscht alle FormError Objekte mit dem angegebenen Namen aus dem Objekt, das FormErrorCollection dem aktuellen Formular zugeordnet ist.
DeleteAll()	Löscht alle Objekte, die FormError in dem -Objekt enthalten sind, das FormErrorCollection dem aktuellen Formular zugeordnet ist.
GetEnumerator()	Ruft ein IEnumerator -Objekt ab, das alle Einträge in der Auflistung durchläuft.
GetErrors(FormErrorType)	Gibt alle FormError Objekte des angegebenen Typs aus dem Objekt zurück, das FormErrorCollection dem aktuellen Formular zugeordnet ist.
GetErrors(String)	Gibt alle FormError Objekte des angegebenen Namens aus dem Objekt zurück, das FormErrorCollection dem aktuellen Formular zugeordnet ist.

Gilt für:

Freigeben über