FormError - Classe

Article
05/11/2015

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

Hiérarchie d’héritage

System.Object
Microsoft.Office.InfoPath.FormError

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

Syntaxe

'Déclaration
Public MustInherit Class FormError
'Utilisation
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.

Exemples

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

Cohérence de thread

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.

Voir aussi

Référence

FormError - Membres

Microsoft.Office.InfoPath - Espace de noms

Partager via