XObject.Changing XObject.Changing XObject.Changing XObject.Changing Event

定義

この XObject またはその子孫が変更される直前に発生します。Raised when this XObject or any of its descendants are about to change.

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) 

次の例では、XML ツリーのルート要素にイベントハンドラーを追加します。The following example adds an event handler to the root element of an XML tree. 次に、ツリーを変更し、LINQ to XML によっていくつかのイベントが発生するようにします。It then modifies the tree, causing LINQ to XML to raise some events.

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  

この例を実行すると、次の出力が生成されます。This example produces the following output:

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

注釈

イベントは、xml ツリーの構築からではなく、XML ツリーの変更によってのみ発生します。Events are raised only from modification of an XML tree, not from construction of an XML tree. イベントを受信する前にイベントにイベントハンドラーを追加する必要があります。また、への参照を取得する前に、 XObjectイベントハンドラーを追加することはできません。You have to add an event handler to an event before you can receive events, and you can't add an event handler before you have a reference to an XObject. XML ツリーを構築する前にXObject 、への参照を取得することはできません。You can't get a reference to an XObject before the XML tree is constructed. つまり、XML ツリーの関数型構築中にイベントを受け取ることはありません。This means that during functional construction of an XML tree, you will not receive events.

これらのイベントのいずれかで XML ツリーを変更する場合は注意が必要です。これを行うと、予期しない結果が生じる可能性があります。You should be careful when modifying an XML tree within one of these events, because doing this might lead to unexpected results. たとえば、イベントを受信Changingしたときにイベントが処理されている間に、ツリーからノードを削除すると、そのChangedイベントを受信できない可能性があります。For example, if you receive a Changing event, and while the event is being processed you remove the node from the tree, you might not receive the Changed event. イベントが処理されるときに、イベントを受け取るノードを含む XML ツリーを変更することが有効です。同じツリーを変更しても、イベントが発生した特定のノードに変更が影響しないようにすることもできます。When an event is being processed, it is valid to modify an XML tree other than the one that contains the node that is receiving the event; it is even valid to modify the same tree provided the modifications do not affect the specific nodes on which the event was raised. ただし、イベントを受信するノードを含むツリーの領域を変更すると、受信したイベントとツリーへの影響が未定義になります。However, if you modify the area of the tree that contains the node receiving the event, the events that you receive and the impact to the tree are undefined.

適用対象

こちらもご覧ください