FormError 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.

Stellt einen Fehler im FormErrorCollection eines Formulars dar.

public ref class FormError abstract

public abstract class FormError

type FormError = class

Public MustInherit Class FormError

Vererbung: Object
FormError

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: " &amp; er.Message)
   MessageBox.Show("Detailed message: " &amp; er.DetailedMessage) 
   MessageBox.Show("Error code: " &amp; er.ErrorCode)
   MessageBox.Show("Error name: " &amp; er.Name);
   MessageBox.Show("Error type: " &amp; er.FormErrorType.ToString())
   MessageBox.Show("Error site XML: " &amp; er.Site.OuterXml.ToString())
End Sub

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 können mithilfe der FormErrorType -Eigenschaft der FormError-Klasse bestimmt werden:

FormErrorType.SchemaValidation Die Datenüberprüfung gibt aufgrund einer im XML-Schema definierten Einschränkung einen Fehler zurück.
Fehler bei der Überprüfung von FormErrorType.SystemGenerated-Daten aufgrund von Einschränkungen, die in der Formulardefinitionsdatei (XSF)-Datei definiert wurden, oder als Ergebnis des Aufrufs der Microsoft.Office.InfoPath.XmlValidatingEventArgs.ReportError -Methode der XmlValidatingEventArgs -Klasse durch Formularcode.
FormErrorType.UserDefined Die Datenüberprüfung ist aufgrund eines benutzerdefinierten Fehlers fehlgeschlagen, der mithilfe der Add -Methode der FormErrorsCollection-Klasse definiert wurde.

Konstruktoren

FormError()

Stellt einen Fehler im FormErrorCollection eines Formulars dar.

Eigenschaften

DetailedMessage	Ruft die detaillierte Meldung ab, die für das -Objekt angezeigt wird, oder legt diese FormError fest.
ErrorCode	Ruft den numerischen Fehlercodewert eines FormError -Objekts ab oder legt diese fest.
FormErrorType	Ruft den Typ des -Objekts ab FormError .
Message	Ruft die für ein FormError -Objekt angezeigte Kurzmeldung ab oder legt diese fest.
Name	Ruft den Namen des FormError -Objekts ab.
Site	Ruft einen XPathNavigator ab, der auf dem Knoten des einem Formular zugrunde liegenden XML-Dokuments positioniert ist, das einem FormError -Objekt zugeordnet ist.

Gilt für:

Freigeben über