FormErrorCollection - Classe
Contient un objet FormError pour chaque erreur dans le formulaire actif.
Hiérarchie d’héritage
System.Object
Microsoft.Office.InfoPath.FormErrorCollection
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustInherit Class FormErrorCollection _
Implements IEnumerable
'Utilisation
Dim instance As FormErrorCollection
public abstract class FormErrorCollection : IEnumerable
Remarques
Un objet FormErrorCollection contient une collection d'objets FormError qui représentent toutes les erreurs se produisant dans le formulaire associé. La collection d'erreurs comprend les erreurs de validation, les erreurs système et les erreurs définies par l'utilisateur (personnalisées). La collection FormErrorCollection fournit des propriétés et des méthodes d'ajout, de suppression et d'accès aux objets FormError qu'elle contient. Vous ne pouvez pas supprimer les erreurs de validation et les erreurs système de cette collection.
Outre la gestion des erreurs générées par InfoPath, la classe FormErrorCollection peut également servir à la création d'erreurs personnalisées à l'aide de la méthode Add.
Notes
Des erreurs personnalisées peuvent également être créées à l'aide de la méthode ReportError de la classe XmlValidatingEventArgs.
Pour accéder à l'objet FormErrorCollection associé à un formulaire, utilisez la propriété Errors de la classe XmlForm.
FormErrorCollection myErrors = this.Errors;
Dim myErrors As FormErrorCollection = Me.Errors
Exemples
Dans l'exemple suivant, un objet XPathNavigator est d'abord placé sur le champ auquel associer une erreur. Ensuite, un XPathNavigator et des détails du message d'erreur sont transmis à la méthode Add de la classe FormErrorCollection pour ajouter l'erreur à la collection d'erreurs du formulaire.
XPathNavigator root, txtbox;
// Create XPathNavigator for main data source.
root = this.MainDataSource.CreateNavigator();
// Create XPathNavigator positioned at field to associate with error.
txtbox = root.SelectSingleNode("//my:field1", this.NamespaceManager);
// Get form's collection of errors and add error.
this.Errors.Add(txtbox, "Field1Error", "Short error message.",
"Detailed error description.", 102057, ErrorMode.Modeless);
Dim root, txtbox As XPathNavigator
' Create XPathNavigator for main data source.
root = Me.MainDataSource.CreateNavigator()
' Create XPathNavigator positioned at field to add error.
txtbox = root.SelectSingleNode("//my:field1", Me.NamespaceManager)
' Get form's collection of errors and add error.
Me.Errors.Add(txtbox, "Field1Error", "Short error message.",
"Detailed error description.", 102057, ErrorMode.Modeless)
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.