This documentation is archived and is not being maintained.

XmlDocument.NodeChanging Event

Occurs when the Value of a node belonging to this document is about to be changed.

[Visual Basic]
Public Event NodeChanging As XmlNodeChangedEventHandler
public event XmlNodeChangedEventHandler NodeChanging;
public: __event XmlNodeChangedEventHandler* NodeChanging;

[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.


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. This event only applies to nodes that have a value.

All nodes created by this document, whether or not they have been inserted into the document, are included in this event.


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