FormError, classe

Article
04/27/2010

Représente une erreur dans la collection FormErrorCollection d'un formulaire.

Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans microsoft.office.infopath.dll)

Syntaxe

Public MustInherit Class FormError

Dim instance As FormError

public abstract class FormError

Remarques

Chaque objet FormError d'un formulaire InfoPath est associé à un nœud du document XML sous-jacent du formulaire. Lorsque la validation des données échoue pour un nœud particulier, InfoPath crée un objet FormError et le place dans la collection FormErrorCollection associée au formulaire.

Trois types d'erreur de validation de données peuvent se produire dans un formulaire InfoPath. Ils peuvent être déterminés à l'aide de la propriété FormErrorType de la classe FormError :

FormErrorType.SchemaValidation La validation des données échoue à cause d'une contrainte de schéma XML.
FormErrorType.SystemGenerated La validation des données échoue à cause de contraintes définies dans le fichier de définition de formulaire (.xsf) ou à la suite de l'appel, par le code de formulaire, de la méthode ReportError de la classe XmlValidatingEventArgs.
FormErrorType.UserDefined La validation des données échoue à cause d'une erreur personnalisée définie à l'aide de la méthode Add de la classe FormErrorsCollection.

Exemple

Dans l'exemple ci-dessous, le contrôle Bouton permet d'obtenir la première erreur de la collection FormErrorCollection du formulaire, puis d'afficher les valeurs de toutes les propriétés de l'objet FormError.

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

Hiérarchie d'héritage

System.Object
Microsoft.Office.InfoPath.FormError

Sécurité des threads

Les membres statiques publics de ce type (Shared en Visual Basic) sont sécurisés au niveau des threads. Il n'est pas garanti que les membres d'instance soient sécurisés au niveau des threads.

Voir aussi

Référence

Membres FormError
Microsoft.Office.InfoPath, espace de noms

Partager via