XmlEvent.Validating Événement

Référence

Définition

Espace de noms:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Se produit après que les modifications apportées au document XML sous-jacent d’un formulaire ont été acceptées, mais avant que l’événement Changed ne se produise.

public:
 abstract event Microsoft::Office::InfoPath::XmlValidatingEventHandler ^ Validating;

public abstract event Microsoft.Office.InfoPath.XmlValidatingEventHandler Validating;

member this.Validating : Microsoft.Office.InfoPath.XmlValidatingEventHandler

Public MustOverride Custom Event Validating As XmlValidatingEventHandler

Type d'événement

XmlValidatingEventHandler

Exceptions

InvalidOperationException

Le développeur a tenté de lier l'événement à un nœud dans une source de données secondaire. Cet événement n'est pas pris en charge pour les sources de données secondaires.

Exemples

Dans l’exemple suivant, une fois qu’une modification a été acceptée pour field9, l’événement Validateing est déclenché et un FormError objet associé à field6 est ajouté à la FormErrorCollection du formulaire à l’aide de la Add(XPathNavigator, String, String, String) méthode .

Cet exemple associe un message d'erreur à field6. La chaîne passée en tant que message paramètre de la méthode Add s’affiche dans un conseil d’écran lorsque l’utilisateur pointe sur field6. Lorsque l’utilisateur clique avec le bouton droit sur field6 , puis clique sur Description complète de l’erreur, InfoPath affiche le message d’erreur complet, y compris la chaîne transmise en tant que messageDetails paramètre de la méthode Add .

public void field9_Validating(object sender, XmlValidatingEventArgs e)
{
   XPathNavigator errNode = 
      this.CreateNavigator().SelectSingleNode("/my:myFields/my:field6", 
      NamespaceManager);

   this.Errors.Add(errNode, "Field9Validating", 
      "Field9 was validated.", 
      "Field9 was validated and an error was assocated with Field6.");
}

Public Sub field9_Validating(ByVal sender As Object, _
   ByVal e As XmlValidatingEventArgs )
   Dim errNode As XPathNavigator = _
      Me.CreateNavigator().SelectSingleNode("/my:myFields/my:field6", _
      NamespaceManager)

   Me.Errors.Add(errNode, "Field9Validating", _
      "Field9 was validated.", _
      "Field9 was validated and an error was associated with Field6.")
End Sub

Remarques

Important : l’événement Validateing n’est pas destiné à être instancié par le développeur dans le code du formulaire. Lorsque vous ajoutez un gestionnaire d’événements à votre modèle de formulaire à partir de l’interface utilisateur en mode Création, Microsoft InfoPath génère du code dans la méthode InternalStartup de votre fichier de code de formulaire à l’aide de la EventManager classe et du membre de la XmlEvent classe pour lier des événements au niveau du document à leurs gestionnaires d’événements. Pour plus d'informations sur l'ajout de gestionnaires d'événements en mode Création dans InfoPath, consultez Procédure : Ajouter un gestionnaire d'événements.

L’événement Validateing est lié à l’aide du XmlValidatingEventHandler délégué.

Ce gestionnaire d'événements ne permet pas aux utilisateurs d'annuler une opération.

Pendant l'événement Validate, le document XML sous-jacent du formulaire est mis en mode lecture seule.

L’événement Validate est généralement utilisé pour gérer les erreurs et utiliser la FormErrorCollection collection, par exemple, pour ajouter de nouvelles erreurs ou supprimer des erreurs existantes.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

S’applique à

Partager via