XmlEvent.Validating, événement

Article
04/27/2010

Se produit après l'acceptation des modifications effectuées dans le document XML sous-jacent d'un formulaire mais avant l'événement Changed.

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

Syntaxe

Public Event Validating As XmlValidatingEventHandler

Dim instance As XmlEvent
Dim handler As XmlValidatingEventHandler

AddHandler instance.Validating, handler

public abstract event XmlValidatingEventHandler Validating

Exceptions

Type d'exception	Condition
InvalidOperationException	Le développeur a tenté de lier l'événement dans un emplacement autre que la méthode InternalStartup.
InvalidOperationException	Le développeur a tenté d'ajouter plusieurs délégués pour la même expression XPath spécifiant un nœud ou un groupe. Vous ne pouvez ajouter qu'un seul délégué pour cet événement par expression XPath d'un nœud ou d'un groupe.
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.

Remarques

Important :
L'événement Validating n'est pas destiné à être instancié par le développeur dans le code de formulaire. Lorsque vous ajoutez un gestionnaire d'événements à votre modèle de formulaire à partir de l'interface utilisateur en mode Création, Microsoft Office InfoPath 2007 génère du code dans la méthode InternalStartup du fichier de code de votre formulaire à l'aide de la classe EventManager et du membre de la classe XmlEvent pour lier les é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 d'ajout d'un gestionnaire d'événements.

L'événement Validating n'est pas destiné à être instancié par le développeur dans le code de formulaire. Lorsque vous ajoutez un gestionnaire d'événements à votre modèle de formulaire à partir de l'interface utilisateur en mode Création, Microsoft Office InfoPath 2007 génère du code dans la méthode InternalStartup du fichier de code de votre formulaire à l'aide de la classe EventManager et du membre de la classe XmlEvent pour lier les é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 d'ajout d'un gestionnaire d'événements.

L'événement Validating est lié à l'aide du délégué XmlValidatingEventHandler.

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 la gestion des erreurs et l'utilisation de la collection FormErrorCollection (par exemple, ajout de nouvelles erreurs ou suppression d'erreurs existantes).

Ce type ou ce membre est accessible à partir du code exécuté dans les formulaires ouverts dans Microsoft Office InfoPath 2007 ou un navigateur Web.

Exemple

Dans l'exemple suivant, après qu'une modification de field9 a été acceptée, l'événement Validating est déclenché et un objet FormError associé à field6 est ajouté à la collection FormErrorCollection du formulaire à l'aide de la méthode Add.

Cet exemple associe un message d'erreur à field6. La chaîne passée en tant que paramètre message de la méthode Add est affichée dans une info-bulle lorsque l'utilisateur fait passer le curseur de la souris 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 passée en tant que paramètre messageDetails 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

Voir aussi

Référence

XmlEvent, classe
Membres XmlEvent
Microsoft.Office.InfoPath, espace de noms

Partager via