使用 XPathNavigator 修改 XML 資料
更新： November 2007
XPathNavigator 類別提供一組可用於修改 XML 文件中節點及值的方法。為了使用這些方法，XPathNavigator 物件必須是可編輯的，也就是說，它的 CanEdit 屬性必須為 true。
可編輯 XML 文件的 XPathNavigator 物件是由 XmlDocument 類別的 CreateNavigator 方法來建立。由 XPathDocument 類別建立的 XPathNavigator 物件是唯讀的，對於 XPathDocument 物件所建立的 XPathNavigator 物件之編輯方法的任何使用嘗試，都會導致擲回 NotSupportedException。
如需建立可編輯 XPathNavigator 物件的詳細資訊，請參閱 使用 XPathDocument 及 XmlDocument 讀取 XML 資料。
修改節點
一種變更節點值的簡單技術是使用 XPathNavigator 類別的 SetValue 及 SetTypedValue 方法。
下表列出了這些方法對不同節點型別的影響。
資料變更 |
|
|---|---|
不支援。 |
|
項目的內容。 |
|
屬性的值。 |
|
文字內容。 |
|
內容 (目標除外)。 |
|
註解的內容。 |
|
不支援。 |
.gif "注意事項") 注意事項： |
|---|
XPathNavigator 類別還提供一組可用於插入及移除節點的方法。如需在 XML 文件中插入及移除節點的詳細資訊，請參閱 使用 XPathNavigator 插入 XML 資料 及 使用 XPathNavigator 移除 XML 資料 主題。
修改不具型別值
SetValue 方法只會插入做為參數傳遞的不具型別 string 值，並將其做為 XPathNavigator 物件目前所在之節點的值。插入的值不具有任何型別，或未根據節點型別 (若提供結構描述資訊) 驗證新值的有效性。
在下列範例中，SetValue 方法用於更新 contosoBooks.xml 檔案中的所有 price 項目。
Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()
Dim manager As XmlNamespaceManager = New XmlNamespaceManager(navigator.NameTable)
manager.AddNamespace("bk", "https://www.contoso.com/books")
For Each nav As XPathNavigator In navigator.Select("//bk:price", manager)
If nav.Value = "11.99" Then
nav.SetValue("12.99")
End If
Next
Console.WriteLine(navigator.OuterXml)
XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();
XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);
manager.AddNamespace("bk", "https://www.contoso.com/books");
foreach (XPathNavigator nav in navigator.Select("//bk:price", manager))
{
if (nav.Value == "11.99")
{
nav.SetValue("12.99");
}
}
Console.WriteLine(navigator.OuterXml);
XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();
XmlNamespaceManager^ manager = gcnew XmlNamespaceManager(navigator->NameTable);
manager->AddNamespace("bk", "https://www.contoso.com/books");
for each (XPathNavigator^ nav in navigator->Select("//bk:price", manager))
{
if(nav->Value == "11.99")
{
nav->SetValue("12.99");
}
}
Console::WriteLine(navigator->OuterXml);
該範例會將 contosoBooks.xml 檔案做為輸入。
<bookstore xmlns="https://www.contoso.com/books">
<book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
<title>The Autobiography of Benjamin Franklin</title>
<author>
<first-name>Benjamin</first-name>
<last-name>Franklin</last-name>
</author>
<price>8.99</price>
</book>
<book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
<title>The Confidence Man</title>
<author>
<first-name>Herman</first-name>
<last-name>Melville</last-name>
</author>
<price>11.99</price>
</book>
<book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
<title>The Gorgias</title>
<author>
<name>Plato</name>
</author>
<price>9.99</price>
</book>
</bookstore>
修改具型別值
當節點的型別為 W3C XML 結構描述簡單型別時，會根據簡單型別的 Facet，對 SetTypedValue 方法插入的新值執行設定前的檢查。如果根據節點的型別，新值無效 (例如，在型別為 xs:positiveInteger 的項目上設定 -1 值)，則會產生例外狀況。
下列範例會嘗試將 contosoBooks.xml 檔案中第一個 book 項目之 price 項目的值，變更為 DateTime 值。因為在 contosoBooks.xsd 檔案中將 price 項目的 XML 結構描述型別定義為 xs:decimal，所以這個動作會擲回例外狀況。
Dim settings As XmlReaderSettings = New XmlReaderSettings()
settings.Schemas.Add("https://www.contoso.com/books", "contosoBooks.xsd")
settings.ValidationType = ValidationType.Schema
Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml", settings)
Dim document As XmlDocument = New XmlDocument()
document.Load(reader)
Dim navigator As XPathNavigator = document.CreateNavigator()
navigator.MoveToChild("bookstore", "https://www.contoso.com/books")
navigator.MoveToChild("book", "https://www.contoso.com/books")
navigator.MoveToChild("price", "https://www.contoso.com/books")
navigator.SetTypedValue(DateTime.Now)
XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("https://www.contoso.com/books", "contosoBooks.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);
XmlDocument document = new XmlDocument();
document.Load(reader);
XPathNavigator navigator = document.CreateNavigator();
navigator.MoveToChild("bookstore", "https://www.contoso.com/books");
navigator.MoveToChild("book", "https://www.contoso.com/books");
navigator.MoveToChild("price", "https://www.contoso.com/books");
navigator.SetTypedValue(DateTime.Now);
該範例會將 contosoBooks.xml 檔案做為輸入。
<bookstore xmlns="https://www.contoso.com/books">
<book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
<title>The Autobiography of Benjamin Franklin</title>
<author>
<first-name>Benjamin</first-name>
<last-name>Franklin</last-name>
</author>
<price>8.99</price>
</book>
<book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
<title>The Confidence Man</title>
<author>
<first-name>Herman</first-name>
<last-name>Melville</last-name>
</author>
<price>11.99</price>
</book>
<book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
<title>The Gorgias</title>
<author>
<name>Plato</name>
</author>
<price>9.99</price>
</book>
</bookstore>
該範例也會將 contosoBooks.xsd 做為輸入。
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="https://www.contoso.com/books" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="bookstore">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="book">
<xs:complexType>
<xs:sequence>
<xs:element name="title" type="xs:string" />
<xs:element name="author">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="name" type="xs:string" />
<xs:element minOccurs="0" name="first-name" type="xs:string" />
<xs:element minOccurs="0" name="last-name" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="price" type="xs:decimal" />
</xs:sequence>
<xs:attribute name="genre" type="xs:string" use="required" />
<xs:attribute name="publicationdate" type="xs:date" use="required" />
<xs:attribute name="ISBN" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
編輯強型別 XML 資料的影響
XPathNavigator 類別使用 W3C XML 結構描述，做為說明強型別 XML 的基礎。根據對 W3C XML 結構描述文件的驗證，可為項目及屬性加上型別資訊附註。可包含其他項目或屬性的項目稱為複雜型別，而那些僅包含文字內容的則稱為簡單型別。
| 注意事項： |
|---|
屬性僅可具有簡單型別。 |
如果項目或屬性符合其型別定義的所有特定規則，則認為是結構描述有效。具有簡單型別 xs:int 的項目必須包含 -2147483648 與 2147483647 之間的數值，才為結構描述有效。對於複雜型別，項目的結構描述有效性取決於其項目子系及屬性的結構描述有效性。因此，如果項目對其複雜型別定義有效，則其所有項目子系及屬性對其型別定義都有效。同樣地，如果項目中有一個項目子系或屬性對其型別定義無效或有效性不明，則該項目也會無效或具有不明有效性。
如果項目的有效性取決於其項目子系及屬性的有效性，則修改任何一項都會導致變更項目的有效性 (如果先前已為有效)。特別是當插入、更新或刪除項目的項目子系或屬性時，項目的有效性會變為不明。此由項目 SchemaInfo 屬性的 Validity 屬性設為 NotKnown 來表示。而且，此影響還會按階層向上遞迴處理整個 XML 文件，因為項目的父項目 (及其父項目等) 有效性也會變為不明。
如需結構描述驗證及 XPathNavigator 類別的詳細資訊，請參閱 使用 XPathNavigator 進行結構描述驗證。
修改屬性
SetValue 及 SetTypedValue 方法可用於修改不具型別與具型別屬性節點，以及＜修改節點＞一節中列出的其他節點型別。
下列範例會變更 books.xml 檔案中第一個 book 項目的 genre 屬性值。
Dim document As XmlDocument = New XmlDocument()
document.Load("books.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()
navigator.MoveToChild("bookstore", String.Empty)
navigator.MoveToChild("book", String.Empty)
navigator.MoveToAttribute("genre", String.Empty)
navigator.SetValue("non-fiction")
navigator.MoveToRoot()
Console.WriteLine(navigator.OuterXml)
XmlDocument document = new XmlDocument();
document.Load("books.xml");
XPathNavigator navigator = document.CreateNavigator();
navigator.MoveToChild("bookstore", String.Empty);
navigator.MoveToChild("book", String.Empty);
navigator.MoveToAttribute("genre", String.Empty);
navigator.SetValue("non-fiction");
navigator.MoveToRoot();
Console.WriteLine(navigator.OuterXml);
如需 SetValue 及 SetTypedValue 方法的詳細資訊，請參閱＜修改不具型別值＞與＜修改具型別值＞這兩節。
InnerXml 及 OuterXml 屬性
XPathNavigator 類別的 InnerXml 及 OuterXml 屬性會變更 XPathNavigator 物件目前所在之節點的 XML 標記。
InnerXml 屬性會變更 XPathNavigator 物件目前所在之子節點的 XML 標記，以及指定 XML string 的已剖析內容。同樣地，OuterXml 屬性會變更 XPathNavigator 物件目前所在之子節點的 XML 標記，以及目前節點本身。
下列範例使用 OuterXml 屬性來修改 price 項目的值，並在 contosoBooks.xml 檔案中的第一個 book 項目上插入新的 discount 屬性。
Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml");
Dim navigator As XPathNavigator = document.CreateNavigator()
navigator.MoveToChild("bookstore", "https://www.contoso.com/books")
navigator.MoveToChild("book", "https://www.contoso.com/books")
navigator.MoveToChild("price", "https://www.contoso.com/books")
navigator.OuterXml = "<price discount=\"0\">10.99</price>"
navigator.MoveToRoot()
Console.WriteLine(navigator.OuterXml)
XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();
navigator.MoveToChild("bookstore", "https://www.contoso.com/books");
navigator.MoveToChild("book", "https://www.contoso.com/books");
navigator.MoveToChild("price", "https://www.contoso.com/books");
navigator.OuterXml = "<price discount=\"0\">10.99</price>";
navigator.MoveToRoot();
Console.WriteLine(navigator.OuterXml);
範例將 contosoBooks.xml 檔案做為輸入。
<bookstore xmlns="https://www.contoso.com/books">
<book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
<title>The Autobiography of Benjamin Franklin</title>
<author>
<first-name>Benjamin</first-name>
<last-name>Franklin</last-name>
</author>
<price>8.99</price>
</book>
<book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
<title>The Confidence Man</title>
<author>
<first-name>Herman</first-name>
<last-name>Melville</last-name>
</author>
<price>11.99</price>
</book>
<book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
<title>The Gorgias</title>
<author>
<name>Plato</name>
</author>
<price>9.99</price>
</book>
</bookstore>
修改命名空間節點
在文件物件模型 (DOM) 中，可將命名空間宣告視為可插入、更新及刪除的一般屬性來處理。XPathNavigator 類別不允許對命名空間節點執行此類作業，原因是變更命名空間節點的值可能會變更命名空間節點範圍內項目及屬性的識別，如下列範例所示。
<root xmlns="https://www.contoso.com">
<child />
</root>
如果上述 XML 範例變更為下列方式，那麼由於變更了每個項目的命名空間 URI 值，所以會有效地重新命名文件中的每個項目。
<root xmlns="urn:contoso.com">
<child />
</root>
XPathNavigator 類別允許插入命名空間節點，但這些命名空間節點不可與其插入所在範圍的命名空間宣告衝突。此情況下的命名空間宣告並不是在 XML 文件中的較低範圍處宣告的，因此不會導致重新命名，如下列範例所示。
<root xmlns:a="https://www.contoso.com">
<parent>
<a:child />
</parent>
</root>
如果上述 XML 範例變更為下列方式，則命名空間宣告便可在 XML 文件中其他命名空間宣告範圍的下面正確傳播。
<root xmlns:a="https://www.contoso.com">
<parent a:parent-id="1234" xmlns:a="https://www.contoso.com/parent-id">
<a:child xmlns:a="https://www.contoso.com/">
</parent>
</root>
在上述 XML 範例中，屬性 a:parent-id 是插入在 https://www.contoso.com/parent-id 命名空間中的 parent 項目上。CreateAttribute 方法用於在定位於 parent 項目上時插入屬性。XPathNavigator 類別會自動插入 https://www.contoso.com 命名空間宣告，以保持 XML 文件其餘內容的一致性。
修改實體參考節點
XmlDocument 物件中的實體參考節點是唯讀的，無法使用 XPathNavigator 或 XmlNode 類別進行編輯。任何修改實體參考節點的嘗試都會導致擲回 InvalidOperationException。
修改 xsi:nil 節點
W3C XML 結構描述建議事項中引進了 Nillable 項目的概念。當項目為 Nillable 時，有可能項目沒有內容但也有效。Nillable 項目的概念與 null 物件的概念類似。主要區別在於任何方式都無法存取 null 物件，而 xsi:nil 項目仍具有可存取的屬性 (Property)，如屬性 (Attribute)，但沒有內容 (項目子系或文字)。如果 XML 文件中有某個項目的 xsi:nil 屬性值為 true，則表示該項目沒有內容。
如果使用 XPathNavigator 物件將內容加入至 xsi:nil 屬性值為 true 的有效項目，則會將其 xsi:nil 屬性值設為 false。
| 注意事項： |
|---|
對於 xsi:nil 屬性設為 false 的項目，即使刪除其內容，該屬性的值也不會變更為 true。 |
儲存 XML 文件
儲存對 XmlDocument 物件所進行的變更 (由本主題中說明的編輯方法所導致) 是使用 XmlDocument 類別的方法來執行。如需儲存 XmlDocument 物件之變更的詳細資訊，請參閱 儲存與寫入文件。