XObject.Changing Событие

Определение

Пространство имен:

System.Xml.Linq

Сборка:

System.Xml.XDocument.dll

Исходный код:

XObject.cs

Возникновение в случае возможного изменения данного XObject или одного из его подчиненных элементов.

public:
 event EventHandler<System::Xml::Linq::XObjectChangeEventArgs ^> ^ Changing;

public event EventHandler<System.Xml.Linq.XObjectChangeEventArgs> Changing;

member this.Changing : EventHandler<System.Xml.Linq.XObjectChangeEventArgs> 

Public Custom Event Changing As EventHandler(Of XObjectChangeEventArgs) 

Тип события

EventHandler<XObjectChangeEventArgs>

Примеры

В следующем примере обработчик событий добавляется в корневой элемент XML-дерева. Затем он изменяет дерево, в результате чего LINQ to XML вызывает некоторые события.

XElement root = new XElement("Root", "content");  
root.Changing += new EventHandler<XObjectChangeEventArgs>(  
    (sender, cea) =>  
    {  
        Console.WriteLine("Changing event raised");  
        XElement xSender = (XElement)sender;  
        Console.WriteLine("  Sender: {0}", xSender.Name);  
        Console.WriteLine("  ObjectChange: {0}", cea.ObjectChange);  
    }  
);  
root.Changed += new EventHandler<XObjectChangeEventArgs>(  
    (sender, cea) =>  
    {  
        Console.WriteLine("Changed event raised");  
        XElement xSender = (XElement)sender;  
        Console.WriteLine("  Sender: {0}", xSender.Name);  
        Console.WriteLine("  ObjectChange: {0}", cea.ObjectChange);  
    }  
);  
root.Add(new XElement("Child", "child content"));  

Module Module1  
    WithEvents root As XElement = <Root>content</Root>  

    Sub Main()  
        root.Add(<Child>child content</Child>)  
    End Sub  

    Private Sub root_Changing( _  
            ByVal sender As Object, _  
            ByVal e As XObjectChangeEventArgs) _  
            Handles root.Changing  
        Dim xSender As XElement = CType(sender, XElement)  
        Console.WriteLine("Changing event raised")  
        Console.WriteLine("  Sender: {0}", xSender.Name)  
        Console.WriteLine("  ObjectChange: {0}", e.ObjectChange)  
    End Sub  

    Private Sub root_Changed( _  
            ByVal sender As Object, _  
            ByVal e As XObjectChangeEventArgs) _  
            Handles root.Changed  
        Dim xSender As XElement = CType(sender, XElement)  
        Console.WriteLine("Changed event raised")  
        Console.WriteLine("  Sender: {0}", xSender.Name)  
        Console.WriteLine("  ObjectChange: {0}", e.ObjectChange)  
    End Sub  
End Module  

В этом примере выводятся следующие данные:

Changing event raised  
  Sender: Child  
  ObjectChange: Add  
Changed event raised  
  Sender: Child  
  ObjectChange: Add  

Комментарии

События возникают только при изменении XML-дерева, а не при создании XML-дерева. Необходимо добавить обработчик событий в событие, прежде чем получать события, и вы не сможете добавить обработчик событий, прежде чем у вас будет ссылка на XObject. Невозможно получить ссылку на XObject до создания XML-дерева. Это означает, что во время функционального построения XML-дерева события не будут отображаться.

При изменении XML-дерева в одном из этих событий следует соблюдать осторожность, так как это может привести к непредвиденным результатам. Например, если вы получаете Changing событие и во время обработки события удаляете узел из дерева, событие может не получить Changed . При обработке события допустимо изменить XML-дерево, отличное от того, которое содержит узел, получающий событие; можно даже изменять то же дерево, если изменения не влияют на конкретные узлы, на которых было создано событие. Однако при изменении области дерева, содержащего узел, принимающий событие, полученные события и влияние на дерево будут неопределенными.

См. также раздел

• Общие сведения о LINQ to XML