Lire en anglais

Partager via


Gestion d'événements dans un document XML à l'aide de XmlNodeChangedEventArgs

XmlNodeChangedEventArgs encapsule les arguments passés aux gestionnaires d’événements inscrits dans l’objet XmlDocument pour la gestion d’événements. Le tableau suivant répertorie ces événements et fournit une description des circonstances dans lesquelles ils sont déclenchés :

Événement Est déclenché
NodeInserting Quand un nœud faisant partie du document actif est sur le point d'être inséré dans un autre nœud.
NodeInserted Quand un nœud faisant partie du document actif a été inséré dans un autre nœud.
NodeRemoving Quand un nœud faisant partie du document en cours est sur le point d'être supprimé du document.
NodeRemoved Quand un nœud faisant partie de ce document a été supprimé de son parent.
NodeChanging Quand la valeur d'un nœud est sur le point d'être modifiée.
NodeChanged Quand la valeur d'un nœud a été modifiée.

Notes

Si l'utilisation de la mémoire XmlDataDocument est pleinement optimisée pour utiliser le stockage DataSet, il est possible que XmlDataDocument ne déclenche aucun des événements répertoriés ci-avant quand des modifications sont apportées au DataSet sous-jacent. Si vous avez besoin de ces événements, vous devez traverser l'intégralité de XmlDocument une fois pour rendre partielle l'utilisation de la mémoire.

L'exemple de code suivant illustre la définition d'un gestionnaire d'événements et l'ajout de celui-ci à un événement :

// Attach the event handler, NodeInsertedHandler, to the NodeInserted  
// event.  
XmlDocument doc = new XmlDocument();  
doc.NodeInserted += new XmlNodeChangedEventHandler(NodeInsertedHandler);  
XmlNode n = doc.CreateElement( "element" );  
Console.WriteLine( "Before Event Inserting" );  
  
// This is the point where the new node is being inserted in the tree,  
// and this is the point where the NodeInserted event is raised.  
doc.AppendChild( n );  
Console.WriteLine( "After Event Inserting" );
  
// Define the event handler that handles the NodeInserted event.  
void NodeInsertedHandler(Object src, XmlNodeChangedEventArgs args)  
{  
    Console.WriteLine("Node " + args.Node.Name + " inserted!!");  
}  

Certaines opérations Document Object Model (DOM) XML sont des opérations composées pouvant entraîner le déclenchement de plusieurs événements. Par exemple, AppendChild peut également avoir à supprimer le nœud ajouté de son ancien parent. Dans ce cas, un événement NodeRemoved est déclenché en premier, suivi d'un événement NodeInserted. Des opérations telles que la définition d'InnerXml peuvent provoquer plusieurs événements.

L'exemple de code suivant montre la création du gestionnaire d'événements et la gestion de l'événement NodeInserted.

using System;  
using System.IO;  
using System.Xml;  
  
public class Sample  
{  
  private const String filename = "books.xml";  
  
  public static void Main()  
  {  
     Sample mySample = new Sample();  
     mySample.Run(filename);  
  }  
  
  public void Run(String args)  
  {  
  
     // Create and load the XML document.  
     Console.WriteLine ("Loading file {0} ...", args);  
     XmlDocument doc = new XmlDocument();  
     doc.Load (args);  
  
     // Create the event handlers.  
     doc.NodeChanged += new XmlNodeChangedEventHandler(this.MyNodeChangedEvent);  
     doc.NodeInserted += new XmlNodeChangedEventHandler(this.MyNodeInsertedEvent);  
  
     // Change the book price.  
     doc.DocumentElement.LastChild.InnerText = "5.95";  
  
     // Add a new element.  
     XmlElement newElem = doc.CreateElement("style");  
     newElem.InnerText = "hardcover";  
     doc.DocumentElement.AppendChild(newElem);  
  
     Console.WriteLine("\r\nDisplay the modified XML...");  
     Console.WriteLine(doc.OuterXml);
  
  }  
  
  // Handle the NodeChanged event.  
  public void MyNodeChangedEvent(Object src, XmlNodeChangedEventArgs args)  
  {  
     Console.Write("Node Changed Event: <{0}> changed", args.Node.Name);  
     if (args.Node.Value != null)  
     {  
        Console.WriteLine(" with value  {0}", args.Node.Value);  
     }  
     else  
       Console.WriteLine("");  
  }  
  
  // Handle the NodeInserted event.  
  public void MyNodeInsertedEvent(Object src, XmlNodeChangedEventArgs args)  
  {  
     Console.Write("Node Inserted Event: <{0}> inserted", args.Node.Name);  
     if (args.Node.Value != null)  
     {  
        Console.WriteLine(" with value {0}", args.Node.Value);  
     }  
     else  
        Console.WriteLine("");  
  }  
  
} // End class

Pour plus d’informations, consultez XmlNodeChangedEventArgs et XmlNodeChangedEventHandler.

Voir aussi