Поделиться через

Обработка событий в XML-документе с помощью XmlNodeChangedEventArgs

  • Статья

Класс XmlNodeChangedEventArgs инкапсулирует аргументы, передаваемые обработчикам событий, которые зарегистрированы в объекте XmlDocument для обработки событий. События и описания условий их срабатывания приведены в следующей таблице.

Событие

Срабатывание

NodeInserting

Перед вставкой узла, принадлежащего текущему документу, в другой узел.

NodeInserted

После вставки узла, принадлежащего текущему документу, в другой узел.

NodeRemoving

Перед удалением узла, принадлежащего этому документу, из документа.

NodeRemoved

После удаления узла, принадлежащего этому документу, из родителя.

NodeChanging

Перед изменением значения узла.

NodeChanged

После изменения значения узла.
ПримечаниеПримечание

Если использование памяти XmlDataDocument полностью оптимизировано для работы хранилища DataSet, то XmlDataDocument может не инициировать ни одно из приведенных выше событий при внесении изменений в базовом хранилище DataSet.Если эти события нужны, то необходимо просмотреть один раз весь XmlDocument, чтобы полностью оптимизировать использование памяти.

В следующем примере кода показано, как определить обработчик событий, и как добавить его к событию.

' Attach the event handler, NodeInsertedHandler, to the NodeInserted
' event.
Dim doc as XmlDocument = new XmlDocument()
Dim XmlNodeChgEHdlr as XmlNodeChangedEventHandler = new XmlNodeChangedEventHandler(addressof MyNodeChangedEvent) 
AddHandler doc.NodeInserted, XmlNodeChgEHdlr 

Dim n as XmlNode = 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.
sub NodeInsertedHandler(src as Object, args as XmlNodeChangedEventArgs)
    Console.WriteLine("Node " + args.Node.Name + " inserted!!")
end sub

// 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!!");
}

Некоторые операции модели DOM представляют собой составные операции, которые могут вызвать срабатывание нескольких событий. Например, AppendChild может также удалить узел, добавляемый из его предыдущего родителя. В этом случае сначала сработает событие NodeRemoved, а затем событие NodeInserted. Такие операции, как установка InnerXml, могут вызывать срабатывание нескольких событий.

В следующем примере кода показано создание обработчика события и обработка события NodeInserted.

Imports System
Imports System.IO
Imports System.Xml
Imports Microsoft.VisualBasic

Public Class Sample

    Private Const filename As String = "books.xml"

    Shared Sub Main()
        Dim mySample As Sample = New Sample()
        mySample.Run(filename)
    End Sub

    Public Sub Run(ByVal args As String)
        ' Create and load the XML document.
        Console.WriteLine("Loading file 0 ...", args)
        Dim doc As XmlDocument = New XmlDocument()
        doc.Load(args)

        ' Create the event handlers.
        Dim XmlNodeChgEHdlr As XmlNodeChangedEventHandler = New XmlNodeChangedEventHandler(AddressOf MyNodeChangedEvent)
        Dim XmlNodeInsrtEHdlr As XmlNodeChangedEventHandler = New XmlNodeChangedEventHandler(AddressOf MyNodeInsertedEvent)
        AddHandler doc.NodeChanged, XmlNodeChgEHdlr
        AddHandler doc.NodeInserted, XmlNodeInsrtEHdlr

        ' Change the book price.
        doc.DocumentElement.LastChild.InnerText = "5.95"

        ' Add a new element.
        Dim newElem As XmlElement = doc.CreateElement("style")
        newElem.InnerText = "hardcover"
        doc.DocumentElement.AppendChild(newElem)

        Console.WriteLine(Chr(13) + Chr(10) + "Display the modified XML...")
        Console.WriteLine(doc.OuterXml)
    End Sub

    ' Handle the NodeChanged event.
    Public Sub MyNodeChangedEvent(ByVal src As Object, ByVal args As XmlNodeChangedEventArgs)
        Console.Write("Node Changed Event: <0> changed", args.Node.Name)
        If Not (args.Node.Value Is Nothing) Then
            Console.WriteLine(" with value  0", args.Node.Value)
        Else
            Console.WriteLine("")
        End If
    End Sub

    ' Handle the NodeInserted event.
    Public Sub MyNodeInsertedEvent(ByVal src As Object, ByVal args As XmlNodeChangedEventArgs)
        Console.Write("Node Inserted Event: <0> inserted", args.Node.Name)
        If Not (args.Node.Value Is Nothing) Then
            Console.WriteLine(" with value 0", args.Node.Value)
        Else
            Console.WriteLine("")
        End If
    End Sub

End Class        ' End class

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

Дополнительные сведения см. в разделах XmlNodeChangeEventArgs Members и XmlNodeChangedEventHandler Delegate.

См. также

Основные понятия

Модель DOM для XML