FormError-Klasse
Stellt einen Fehler in FormErrorCollection eines Formulars dar.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)
Syntax
Public MustInherit Class FormError
Dim instance As FormError
public abstract class FormError
Hinweise
Jedes FormError-Objekt in einem InfoPath-Formular ist mit einem Knoten im XML-Dokument des zugrunde liegenden Formulars verknüpft. Wenn die Datenüberprüfung für einen bestimmten Knoten einen Fehler zurückgibt, wird von InfoPath ein FormError-Objekt erstellt und in dem mit dem Formular verknüpften FormErrorCollection-Objekt platziert.
Es gibt drei Typen von Datenüberprüfungsfehlern, die in einem InfoPath-Formular auftreten können. Sie lassen sich mithilfe der FormErrorType-Eigenschaft der FormError-Klasse bestimmen:
FormErrorType.SchemaValidation Die Datenüberprüfung gibt aufgrund einer im XML-Schema definierten Einschränkung einen Fehler zurück.
FormErrorType.SystemGenerated Die Datenüberprüfung gibt aufgrund von Einschränkungen einen Fehler zurück, die in der Formulardefinitionsdatei (XSF) definiert sind, oder aufgrund von Formularcode, der die ReportError-Methode der XmlValidatingEventArgs-Klasse aufruft.
FormErrorType.UserDefined Die Datenüberprüfung ist aufgrund eines benutzerdefinierten Fehlers fehlgeschlagen, für den die Add-Methode der FormErrorsCollection-Klasse verwendet wurde.
Beispiel
Im folgenden Beispiel wird durch Klicken auf das Steuerelement Schaltfläche der erste Fehler in FormErrorCollection des Formulars abgerufen. Dann werden die Werte für alle Eigenschaften des FormError-Objekts angezeigt.
public void ErrorBtn_Clicked(object sender, ClickedEventArgs e)
{
FormError er = this.Errors[0];
MessageBox.Show("Short message: " + er.Message);
MessageBox.Show("Detailed message: " + er.DetailedMessage);
MessageBox.Show("Error code: " + er.ErrorCode);
MessageBox.Show("Error name: " + er.Name);
MessageBox.Show("Error type: " + er.FormErrorType.ToString());
MessageBox.Show("Error site XML: " + er.Site.OuterXml.ToString());
}
Public Sub ErrorBtn_Clicked(ByVal sender As Object, _
ByVal e As ClickedEventArgs)
FormError er = Me.Errors(0)
MessageBox.Show("Short message: " & er.Message)
MessageBox.Show("Detailed message: " & er.DetailedMessage)
MessageBox.Show("Error code: " & er.ErrorCode)
MessageBox.Show("Error name: " & er.Name);
MessageBox.Show("Error type: " & er.FormErrorType.ToString())
MessageBox.Show("Error site XML: " & er.Site.OuterXml.ToString())
End Sub
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.FormError
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.