XML 文件物件模型—-從XmlDocument 處理事件

如何處理來自 XmlDocument 的事件

此樣本闡釋當 XML 文檔中的節點更改時，如何接收和處理事件。特別要說明的是，此樣本說明了如何捕獲以下段落中說明的 NodeChanged 和 NodeInserted 事件。

修改 XmlDocument 可能會引起下面的一個或多個事件：

• 當屬於 XmlDocument 的任何節點被插入其他節點時，將發生 NodeInserted 事件。這包括由此文檔建立的所有節點，不論它們是在文檔樹的內部還是外部，包括屬性節點。
• 當把屬於此文檔的任何節點從其父級移除時，將發生 NodeRemoved 事件。這包括由此文檔建立的所有節點，不論它們是在文檔樹的內部還是外部，包括屬性節點。
• 當屬於此文檔的任何節點的 Value 屬性被更改時，將發生 NodeChanged 事件。這僅應用於有 Value 屬性的節點。
• 當屬於此文檔的任何節點要被插入、移除或更改時，將發生 NodeInserting、NodeRemoving 或 NodeChanging 事件。

這些事件使您可以在要停止操作時引發異常。XmlDocument 確保在引發異常後，文檔將回到操作開始前的狀態。

VB XmlDocumentEvent.aspx [運行樣本] | [查看原始碼]

在將 books.xml 檔案載入到 XmlDocument 後，此應用程式範例修改文檔中現有書籍的價格，並向文檔中添加新書。這些更改將導致 NodeChanged 和 NodeInserted 事件。

下列範例程式碼構造一個 XmlDocument 並載入 books.xml。

XmlDocument myXmlDocument = new XmlDocument(); myXmlDocument.Load (args); Dim myXmlDocument as XmlDocument = new XmlDocument() myXmlDocument.Load (args)
C#	VB

該樣本載入完 books.xml 以後，即將 NodeChanged 和 NodeInserted 事件處理常式添加到 XmlDocument。（這些處理常式的代碼將出現在本主題的後面部分中。）

myXmlDocument.NodeChanged += new XmlNodeChangedEventHandler(this.MyNodeChangedEvent); myXmlDocument.NodeInserted += new XmlNodeChangedEventHandler(this.MyNodeInsertedEvent); AddHandler myXmlDocument.NodeChanged, new XmlNodeChangedEventHandler(addressof MyNodeChangedEvent) AddHandler myXmlDocument.NodeInserted, new XmlNodeChangedEventHandler(addressof MyNodeInsertedEvent)
C#	VB

該應用程式範例更改文檔中的資料，將每本書的價格增加 2%。為此，該樣本必須首先使用 XmlNode 類的 SelectNodes 方法選擇要更改的資料。通過使用 SelectNodes 方法的 XML 路徑語言 (Xpath) 運算式“descendant::book/price”，該樣本選擇所有書籍元素的價格子項目。然後，應用程式將這些選定的節點置於 XmlNodeList 中，在那裡將對它們進行編輯，以反映 2% 的價格增長情況。價格增長操作包括以下步驟：擷取價格元素的 InnerText 值，將該值增加 2%，然後將修改後的值插回到元素中。每當價格元素更改時，都有一個 NodeChanged 事件將新價格輸出到螢幕上。（NodeChanged 事件的代碼將出現在本主題的後面部分中。）

// Increase all the book prices by 2% ... // Create a list of the nodes and change their values XmlNodeList myXmlNodeList = myXmlDocument.SelectNodes("descendant::book/price"); foreach (XmlNode myXmlNode in myXmlNodeList) { Console.WriteLine("<" + myXmlNode.Name + "> " + myXmlNode.InnerText); Double price = Double.Parse(myXmlNode.InnerText); myXmlNode.InnerText = (((Double)price * 1.02).ToString("#.00")); } ' Increase all the book prices by 2% ... ' Create a list of the nodes and change their values Dim myXmlNodeList as XmlNodeList = myXmlDocument.SelectNodes("descendant::book/price") Dim myXmlNode as XmlNode for each myXmlNode in myXmlNodeList Console.WriteLine("<" + myXmlNode.Name + "> " + myXmlNode.InnerText) Dim price as Double = System.Double.Parse(myXmlNode.InnerText) myXmlNode.InnerText = CStr(CType(price * 1.02, Double).ToString("#.00")) next
C#	VB

該應用程式範例還將一個節點插入 XmlDocument。一個插入新節點的簡單方法是：建立一個 XmlDocumentFragment，確定要在文檔中插入片段的位置，然後使用 XmlDocument 的 InsertBefore 或 InsertAfter 方法。如下列代碼所示，該樣本使用已準備好的 XML 的字串建立 XmlDocumentFragment，然後將此片段插入 XmlDocument。插入新節點後，即發生 NodeInserted 事件，將新節點資訊輸出到螢幕上。（NodeInserted 事件的代碼將出現在本主題的後面部分中。）

// Create a new book XmlDocumentFragment myNewBook = myXmlDocument.CreateDocumentFragment(); myNewBook.InnerXml = ("" + "" + "" + "Eric" + "Gamma" + "" + " 49.95 " + ""); XmlElement rootXmlElement = myXmlDocument.DocumentElement; // Add the new book to the XmlDocument rootXmlElement.InsertBefore(myNewBook, rootXmlElement.FirstChild); ... // Clone the node and note that by cloning the node we // are inserting it again into the XmlDocument XmlNode myNewBook2 = myXmlDocument.DocumentElement.FirstChild.Clone(); ' Create a new book Dim myNewBook as XmlDocumentFragment = myXmlDocument.CreateDocumentFragment() myNewBook.InnerXml = ("" & _ "" & _ "" & _ "Eric" & _ "Gamma" & _ "" & _ " 49.95 " & _ "") Dim rootXmlElement as XmlElement = myXmlDocument.DocumentElement ' Add the new book to the XmlDocument rootXmlElement.InsertBefore(myNewBook, rootXmlElement.FirstChild) ... ' Clone the node and note that by cloning the node we ' are inserting it again into the XmlDocument Dim myNewBook2 as XmlNode = myXmlDocument.DocumentElement.FirstChild.Clone()
C#	VB

下列代碼說明處理 NodeChanged 和 NodeInserted 事件的函數。

// Handle the Node Changed Event public void MyNodeChangedEvent(Object src, XmlNodeChangedEventArgs args) { Console.Write("Node Changed Event: <" + args.Node.Name + "> changed"); if (args.Node.Value != null) { Console.WriteLine(" with value " + args.Node.Value); } else Console.WriteLine(""); } // Handle the Node Inserted Event public void MyNodeInsertedEvent(Object src, XmlNodeChangedEventArgs args) { Console.Write("Node Inserted Event: <" + args.Node.Name + "> inserted"); if (args.Node.Value != null) { Console.WriteLine(" with value " + args.Node.Value); } else Console.WriteLine(""); } ' Handle the Node Changed Event public sub MyNodeChangedEvent(src as Object , args as XmlNodeChangedEventArgs ) Console.Write("Node Changed Event: <" + args.Node.Name + "> changed") if not (args.Node.Value is Nothing) then Console.WriteLine(" with value " + args.Node.Value) else Console.WriteLine("") end if end sub ' Handle the Node Inserted Event public sub MyNodeInsertedEvent(src as Object , args as XmlNodeChangedEventArgs ) Console.Write("Node Inserted Event: <" + args.Node.Name + "> inserted") if not (args.Node.Value is Nothing) then Console.WriteLine(" with value " + args.Node.Value) else Console.WriteLine("") end if end sub
C#	VB

摘要

1. 要編輯節點值，首先使用 SelectNodes 選擇節點，然後將選定的節點放到 XmlNodeList 中。
2. 有六個可處理的節時間點事件：NodeInserted、NodeRemoved、NodeChanged、NodeInserting、NodeRemoving 或 NodeChanging。
3. 要處理節點，可將節點處理常式添加到 XmlDocument 的執行個體中。