FormErrorCollection Classe

Définition

public ref class FormErrorCollection abstract : System::Collections::IEnumerable

public abstract class FormErrorCollection : System.Collections.IEnumerable

type FormErrorCollection = class
    interface IEnumerable

Public MustInherit Class FormErrorCollection
Implements IEnumerable

Héritage

Object

FormErrorCollection

Implémente

IEnumerable

Exemples

Dans l'exemple suivant, un objet XPathNavigator est d'abord placé sur le champ auquel associer une erreur. Ensuite, les détails XPathNavigator et du message d’erreur sont transmis à la Add méthode 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)

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.

En plus de gérer les erreurs générées par InfoPath, la classe FormErrorCollection peut également être utilisée pour créer des erreurs personnalisées à l’aide de la Add méthode .

Remarque : des erreurs personnalisées peuvent également être créées à l’aide de la ReportError méthode de la XmlValidatingEventArgs classe .

Pour accéder à l’objet FormErrorCollection associé à un formulaire, utilisez la Errors propriété de la XmlForm classe .

FormErrorCollection myErrors = this.Errors; Dim myErrors As FormErrorCollection = Me.Errors

Constructeurs

Propriétés

Méthodes

S’applique à