Freigeben über


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.

Siehe auch

Referenz

FormError-Member

Microsoft.Office.InfoPath-Namespace