XmlDocument.NodeInserting Event
Occurs when a node belonging to this document is about to be inserted into another node.
[Visual Basic] Public Event NodeInserting As XmlNodeChangedEventHandler [C#] public event XmlNodeChangedEventHandler NodeInserting; [C++] public: __event XmlNodeChangedEventHandler* NodeInserting;
[JScript] In JScript, you can handle the events defined by a class, but you cannot define your own.
Event Data
The event handler receives an argument of type XmlNodeChangedEventArgs containing data related to this event. The following XmlNodeChangedEventArgs properties provide information specific to this event.
| Property | Description |
|---|---|
| Action | Gets a value indicating what type of node change event is occurring. |
| NewParent | Gets the value of the ParentNode after the operation completes. |
| Node | Gets the XmlNode that is being added, removed or changed. |
| OldParent | Gets the value of the ParentNode before the operation began. |
Remarks
This event allows the user to do extra checking and, if necessary, throw an exception to stop the operation. If an exception is thrown the XmlDocument returns to its original state.
All nodes created by this document, whether or not they have been inserted into the document, are included in this event.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
See Also
XmlDocument Class | XmlDocument Members | System.Xml Namespace