XmlEvent.Validating, événement
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
'Déclaration
Public MustOverride Event Validating As XmlValidatingEventHandler
'Utilisation
Dim instance As XmlEvent
Dim handler As XmlValidatingEventHandler
AddHandler instance.Validating, handler
public abstract event XmlValidatingEventHandler Validating
Exceptions
| 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 InfoPath 2010 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 InfoPath Filler ou dans un navigateur Web.
Exemples
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