FormError-Klasse
Stellt einen Fehler in FormErrorCollection eines Formulars dar.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.FormError
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class FormError
'Usage
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.
Beispiele
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
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.