XmlEvent.Changing, événement

Article
04/27/2010

Se produit après que des modifications ont été apportées au document XML sous-jacent d'un formulaire mais avant qu'elles aient été acceptées.

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

Syntaxe

Public Event Changing As XmlChangingEventHandler

Dim instance As XmlEvent
Dim handler As XmlChangingEventHandler

AddHandler instance.Changing, handler

public abstract event XmlChangingEventHandler Changing

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é de lier l'événement à un nœud dans la 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 Changing 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 Changing 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 Changing est lié à l'aide du délégué XmlChangingEventHandler.

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

Pendant l'événement Changing, le document XML sous-jacent du formulaire est mis en mode lecture seule. Si la propriété XmlChangingEventArgs.CancelableArgs.Cancel est affectée de la valeur true, InfoPath refuse les modifications apportées et un message est affiché à l'intention de l'utilisateur. Si une erreur se produit dans le code de l'événement Changing, InfoPath rejette les modifications et rétablit l'état précédent des données.

Remarque
Il est préférable d'éviter de changer de vue pendant l'événement Changing ; les modifications n'ont pas encore été acceptées et le changement de vue risque de provoquer une erreur.

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

Exemple

Dans l'exemple suivant, une modification apportée à field2 déclenche un événement Changing et un objet FormError associé à field1 est ajouté à la collection FormErrorCollection du formulaire à l'aide de la méthode Add de la classe FormErrorCollection.

Cet exemple associe un message d'erreur à field1. 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 field1. Lorsque l'utilisateur clique avec le bouton droit sur field1 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 field2_Changing(object sender, XmlChangingEventArgs e)
{
   XPathNavigator errNode = 
      this.CreateNavigator().SelectSingleNode("/my:myFields/my:field1", 
      NamespaceManager);
   this.Errors.Add(errNode, "Field2Changing", 
      "The Changing event occurred for Field2.", 
      "Changes were made to Field2, but have not yet been accepted.");
}

Public Sub field2_Changing(ByVal sender As Object, _
   ByVal e As XmlChangingEventArgs)
   Dim errNode As XPathNavigator = Me.CreateNavigator(). _
      SelectSingleNode("/my:myFields/my:field1", NamespaceManager)
   Me.Errors.Add(errNode, "Field2Changing", _
      "The Changing event occurred for Field2.", _
      "Changes were made, but have not yet been accepted.")
End Sub

Voir aussi

Référence

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

Partager via