使用 XPathNavigator 插入 XML 数据

项目
04/07/2023

XPathNavigator 类提供一组方法用于在 XML 文档中插入同级节点、子节点和属性节点。要使用这些方法，XPathNavigator 对象必须可编辑，即其 CanEdit 属性必须为 true。

可以编辑 XML 文档的 XPathNavigator 对象由 CreateNavigator 类的 XmlDocument 方法创建。由 XPathNavigator 类创建的 XPathDocument 对象是只读的，如果尝试使用由 XPathNavigator 对象创建的 XPathDocument 对象的编辑方法，将引发 NotSupportedException。

若要详细了解如何创建可编辑 XPathNavigator 对象，请参阅使用 XPathDocument 和 XmlDocument 读取 XML 数据。

插入节点

XPathNavigator 类提供在 XML 文档中插入同级节点、子节点和属性节点的方法。通过这些方法可以在与 XPathNavigator 对象的当前位置有关的不同位置插入节点和属性，如下面各节所述。

插入同级节点

XPathNavigator 类提供下列方法来插入同辈节点。

这些方法在 XPathNavigator 对象当前所处的节点之前和之后插入同辈节点。

InsertAfter 和 InsertBefore 方法是重载方法，接受 string、XmlReader 对象或包含要作为参数添加的同级节点的 XPathNavigator 对象。这两种方法还会返回用于插入同级节点的 XmlWriter 对象。

InsertElementAfter 和 InsertElementBefore 方法使用命名空间前缀、本地名称、命名空间 URI 以及作为参数指定的值在 XPathNavigator 对象当前所处的节点之前和之后插入单个同级节点。

在以下示例中，在 pages 文件中第一个 price 元素的 book 子元素之前插入新的 contosoBooks.xml 元素。

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToChild("bookstore", "http://www.contoso.com/books");
navigator->MoveToChild("book", "http://www.contoso.com/books");
navigator->MoveToChild("price", "http://www.contoso.com/books");

navigator->InsertBefore("<pages>100</pages>");

navigator->MoveToParent();
Console::WriteLine(navigator->OuterXml);

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");
navigator.MoveToChild("price", "http://www.contoso.com/books");

navigator.InsertBefore("<pages>100</pages>");

navigator.MoveToParent();
Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")
navigator.MoveToChild("price", "http://www.contoso.com/books")

navigator.InsertBefore("<pages>100</pages>")

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

该示例使用 contosoBooks.xml 文件作为输入。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://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>

有关 InsertAfter、InsertBefore、InsertElementAfter 和 InsertElementBefore 方法的更多信息，请参见 XPathNavigator 类参考文档。

插入子节点

XPathNavigator 类提供下列方法来插入子节点。

这些方法在 XPathNavigator 对象当前所处的节点的子节点列表的结尾和开头添加子节点。

与“插入同级节点”一节中的方法类似，AppendChild 和 PrependChild 方法接受 string、XmlReader 对象或包含要作为参数添加的子节点的 XPathNavigator 对象。这两种方法还会返回用于插入子节点的 XmlWriter 对象。

AppendChildElement 和 PrependChildElement 方法也与“插入同级节点”一节中的方法类似，使用命名空间前缀、本地名称、命名空间 URI 以及作为参数指定的值在 XPathNavigator 对象当前所处的节点的子节点列表的结尾和开头插入单个子节点。

在以下示例中，在 pages 文件中第一个 book 元素的子元素列表上追加新的 contosoBooks.xml 子元素。

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToChild("bookstore", "http://www.contoso.com/books");
navigator->MoveToChild("book", "http://www.contoso.com/books");

navigator->AppendChild("<pages>100</pages>");

Console::WriteLine(navigator->OuterXml);

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");

navigator.AppendChild("<pages>100</pages>");

Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")

navigator.AppendChild("<pages>100</pages>")

Console.WriteLine(navigator.OuterXml)

该示例使用 contosoBooks.xml 文件作为输入。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://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>

有关 AppendChild、PrependChild、AppendChildElement 和 PrependChildElement 方法的更多信息，请参见 XPathNavigator 类参考文档。

插入属性节点

XPathNavigator 类提供下列方法来插入属性节点。

这些方法在 XPathNavigator 对象当前所处的元素节点上插入属性节点。 CreateAttribute 方法使用命名空间前缀、本地名称、命名空间 URI 以及作为参数指定的值在 XPathNavigator 对象当前所处的元素节点上创建属性节点。 CreateAttributes 方法返回用于插入属性节点的 XmlWriter 对象。

在以下示例中，使用从 discount 方法返回的 currency 对象在 price 文件中第一个 book 元素的 contosoBooks.xml 子元素上创建新的 XmlWriter 和 CreateAttributes 属性。

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToChild("bookstore", "http://www.contoso.com/books");
navigator->MoveToChild("book", "http://www.contoso.com/books");
navigator->MoveToChild("price", "http://www.contoso.com/books");

XmlWriter^ attributes = navigator->CreateAttributes();

attributes->WriteAttributeString("discount", "1.00");
attributes->WriteAttributeString("currency", "USD");
attributes->Close();

navigator->MoveToParent();
Console::WriteLine(navigator->OuterXml);

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");
navigator.MoveToChild("price", "http://www.contoso.com/books");

XmlWriter attributes = navigator.CreateAttributes();

attributes.WriteAttributeString("discount", "1.00");
attributes.WriteAttributeString("currency", "USD");
attributes.Close();

navigator.MoveToParent();
Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")
navigator.MoveToChild("price", "http://www.contoso.com/books")

Dim attributes As XmlWriter = navigator.CreateAttributes()

attributes.WriteAttributeString("discount", "1.00")
attributes.WriteAttributeString("currency", "USD")
attributes.Close()

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

该示例使用 contosoBooks.xml 文件作为输入。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://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>

有关 CreateAttribute 和 CreateAttributes 方法的更多信息，请参见 XPathNavigator 类参考文档。

复制节点

在某些情况下，可能需要使用另一个 XML 文档中的内容填充 XML 文档。 XPathNavigator 类和 XmlWriter 类均可以将节点从现有的 XmlDocument 对象或 XmlReader 对象复制到 XPathNavigator 对象。

AppendChild 类的 PrependChild、InsertBefore、InsertAfter 和 XPathNavigator 方法全部具有重载，可以接受 XPathNavigator 对象或 XmlReader 对象作为参数。

WriteNode 类的 XmlWriter 方法具有重载，可以接受 XmlNode、XmlReader 或 XPathNavigator 对象。

以下示例将所有 book 元素从一个文档复制到另一个文档。

Dim document As XmlDocument = New XmlDocument()  
document.Load("books.xml")  
Dim navigator As XPathNavigator = document.CreateNavigator()  
  
navigator.MoveToChild("bookstore", String.Empty)  
  
Dim newBooks As XPathDocument = New XPathDocument("newBooks.xml")  
Dim newBooksNavigator As XPathNavigator = newBooks.CreateNavigator()  
  
Dim nav As XPathNavigator  
For Each nav in newBooksNavigator.SelectDescendants("book", "", false)  
    navigator.AppendChild(nav)  
Next  
  
document.Save("newBooks.xml");

XmlDocument document = new XmlDocument();  
document.Load("books.xml");  
XPathNavigator navigator = document.CreateNavigator();  
  
navigator.MoveToChild("bookstore", String.Empty);  
  
XPathDocument newBooks = new XPathDocument("newBooks.xml");  
XPathNavigator newBooksNavigator = newBooks.CreateNavigator();  
  
foreach (XPathNavigator nav in newBooksNavigator.SelectDescendants("book", "", false))  
{  
    navigator.AppendChild(nav);  
}  
  
document.Save("newBooks.xml");

插入值

XPathNavigator 类提供 SetValue 和 SetTypedValue 方法来将节点的值插入 XmlDocument 对象。

插入非类型化的值

SetValue 方法只需将作为参数传递的非类型化的 string 值作为 XPathNavigator 对象当前所处的节点的值插入。插入的值没有任何类型或不验证新值是否符合节点的类型（如果架构信息可用）。

在以下示例中，SetValue 方法用于更新 price 文件中的所有 contosoBooks.xml 元素。

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

XmlNamespaceManager^ manager = gcnew XmlNamespaceManager(navigator->NameTable);
manager->AddNamespace("bk", "http://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);

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);
manager.AddNamespace("bk", "http://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);

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", "http://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)

该示例使用 contosoBooks.xml 文件作为输入。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://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 架构的简单类型，在设置值之前，将针对简单类型的各个方面检查通过 SetTypedValue 方法插入的新值。如果新值不符合节点的类型（例如在类型为 -1 的元素上设置值 xs:positiveInteger），将引发异常。

以下示例尝试将 price 文件中第一个 book 元素的 contosoBooks.xml 元素的值更改为 DateTime 值。因为在 price 文件中将 xs:decimal 元素的 XML 架构类型定义为 contosoBooks.xsd，所以，这样做将引发异常。

Dim settings As XmlReaderSettings = New XmlReaderSettings()  
settings.Schemas.Add("http://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", "http://www.contoso.com/books")  
navigator.MoveToChild("book", "http://www.contoso.com/books")  
navigator.MoveToChild("price", "http://www.contoso.com/books")  
  
navigator.SetTypedValue(DateTime.Now)

XmlReaderSettings settings = new XmlReaderSettings();  
settings.Schemas.Add("http://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", "http://www.contoso.com/books");  
navigator.MoveToChild("book", "http://www.contoso.com/books");  
navigator.MoveToChild("price", "http://www.contoso.com/books");  
  
navigator.SetTypedValue(DateTime.Now);

该示例使用 contosoBooks.xml 文件作为输入。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://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="http://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>

InnerXml 和 OuterXml 属性

InnerXml 类的 OuterXml 和 XPathNavigator 属性更改 XPathNavigator 对象当前所处的节点的 XML 标记。

InnerXml 属性更改 XPathNavigator 对象当前所处的子节点以及给定 XML string 的已分析内容的 XML 标记。同样，OuterXml 属性更改 XPathNavigator 对象当前所处的子节点以及当前节点本身的 XML 标记。

除了本主题中所述的方法之外，InnerXml 和 OuterXml 属性也可以用于在 XML 文档中插入节点和值。若要详细了解如何使用 InnerXml 和 OuterXml 属性插入节点和值，请参阅使用 XPathNavigator 修改 XML 数据主题。

命名空间和 xml:lang 冲突

在使用 xml:lang 类的 InsertBefore、InsertAfter、AppendChild 和 PrependChild 方法（这些方法使用 XPathNavigator 对象作为参数）插入 XML 数据时，可能会发生某些与命名空间和 XmlReader 声明的范围有关的冲突，。

以下是可能发生的命名空间冲突。

如果在 XmlReader 对象的上下文范围内存在命名空间，其中命名空间 URI 映射的前缀不在 XPathNavigator 对象的上下文中，新的命名空间声明将添加到新插入的节点。
如果 XmlReader 对象的上下文和 XPathNavigator 对象的上下文范围内存在相同的命名空间 URI，但是两个上下文中映射到该命名空间 URI 的前缀不同，新的命名空间声明将添加到新插入的节点，前缀和命名空间 URI 从 XmlReader 对象获取。
如果 XmlReader 对象的上下文和 XPathNavigator 对象的上下文范围内存在相同的命名空间前缀，但是两个上下文中映射到该命名空间前缀的命名空间 URI 不同，新的命名空间声明将添加到新插入的节点，该声明使用从 XmlReader 对象获取的命名空间 URI 重新声明该前缀。
如果 XmlReader 对象的上下文和 XPathNavigator 对象的上下文中的前缀以及命名空间 URI 相同，则不会向新插入的节点添加新的命名空间声明。

注意

上面的说明同样适用于使用空 string 作为前缀的命名空间声明（例如默认的命名空间声明）。

以下是可能发生的 xml:lang 冲突。

如果 xml:lang 对象的上下文范围内存在 XmlReader 属性，但是 XPathNavigator 对象的上下文范围内没有，从 xml:lang 对象获取值的 XmlReader 属性将添加到新插入的节点。
如果 xml:lang 对象的上下文和 XmlReader 对象的上下文范围内均存在 XPathNavigator 属性，但是每个属性的值不同，从 xml:lang 对象获取值的 XmlReader 属性将添加到新插入的节点。
如果 xml:lang 对象的上下文和 XmlReader 对象的上下文范围内均存在 XPathNavigator 属性，但是每个属性的值相同，则不会向新插入的节点添加新的 xml:lang 属性。
如果 xml:lang 对象的上下文范围内存在 XPathNavigator 属性，但是 XmlReader 对象的上下文范围内不存在，则不会向新插入的节点添加 xml:lang 属性。

使用 XmlWriter 插入节点

“插入节点和值”一节中所述的用于插入同级节点、子节点和属性节点的方法均是重载方法。 InsertAfter 类的 InsertBefore、AppendChild、PrependChild、CreateAttributes 和 XPathNavigator 方法返回用于插入节点的 XmlWriter 对象。

不支持的 XmlWriter 方法

因为 XPath 数据模型与文档对象模型 (DOM) 之间存在差异，所以，XmlWriter 类并非支持所有用于使用 XPathNavigator 类向 XML 文档写入信息的方法。

下表说明 XmlWriter 类不支持的 XPathNavigator 类方法。

方法	描述
WriteEntityRef	引发 NotSupportedException 异常。
WriteDocType	在根级别忽略，如果在 XML 文档中的任何其他级别调用，将引发 NotSupportedException 异常。
WriteCData	看作对等效字符调用 WriteString 方法。
WriteCharEntity	看作对等效字符调用 WriteString 方法。
WriteSurrogateCharEntity	看作对等效字符调用 WriteString 方法。

有关 XmlWriter 类的更多信息，请参见 XmlWriter 类参考文档。

多个 XmlWriter 对象

可能存在多个 XPathNavigator 对象，指向包含一个或多个打开的 XmlWriter 对象的 XML 文档的不同部分。在单线程方案中允许并支持多个 XmlWriter 对象。

以下是在使用多个 XmlWriter 对象时要考虑的重要事项。

在调用每个 XmlWriter 对象的 Close 方法时，通过 XmlWriter 对象编写的 XML 片断将添加到 XML 文档中。直到此时，XmlWriter 对象一直在编写断开的片断。如果对 XML 文档执行某项操作，在调用 XmlWriter 之前，任何通过 Close 对象编写的片断不会受影响。
如果特定 XML 子树上存在打开的 XmlWriter 对象并且该子树已删除，XmlWriter 对象仍可以添加到子树上。只是子树成为已删除的片断。
如果在 XML 文档的相同位置打开多个 XmlWriter 对象，这些对象将按照 XmlWriter 对象关闭的顺序添加到 XML 文档，而不是按照对象打开的顺序。

以下示例创建一个 XmlDocument 对象，创建一个 XPathNavigator 对象，然后使用 XmlWriter 方法返回的 PrependChild 对象在 books.xml 文件中创建第一本图书的结构。然后，示例将其保存为 book.xml 文件。

Dim document As XmlDocument = New XmlDocument()  
Dim navigator As XPathNavigator = document.CreateNavigator()  
  
Using writer As XmlWriter = navigator.PrependChild()  
  
    writer.WriteStartElement("bookstore")  
    writer.WriteStartElement("book")  
    writer.WriteAttributeString("genre", "autobiography")  
    writer.WriteAttributeString("publicationdate", "1981-03-22")  
    writer.WriteAttributeString("ISBN", "1-861003-11-0")  
    writer.WriteElementString("title", "The Autobiography of Benjamin Franklin")  
    writer.WriteStartElement("author")  
    writer.WriteElementString("first-name", "Benjamin")  
    writer.WriteElementString("last-name", "Franklin")  
    writer.WriteElementString("price", "8.99")  
    writer.WriteEndElement()  
    writer.WriteEndElement()  
    writer.WriteEndElement()  
  
End Using  
  
document.Save("book.xml")

XmlDocument document = new XmlDocument();  
XPathNavigator navigator = document.CreateNavigator();  
  
using (XmlWriter writer = navigator.PrependChild())  
{  
    writer.WriteStartElement("bookstore");  
    writer.WriteStartElement("book");  
    writer.WriteAttributeString("genre", "autobiography");  
    writer.WriteAttributeString("publicationdate", "1981-03-22");  
    writer.WriteAttributeString("ISBN", "1-861003-11-0");  
    writer.WriteElementString("title", "The Autobiography of Benjamin Franklin");  
    writer.WriteStartElement("author");  
    writer.WriteElementString("first-name", "Benjamin");  
    writer.WriteElementString("last-name", "Franklin");  
    writer.WriteElementString("price", "8.99");  
    writer.WriteEndElement();  
    writer.WriteEndElement();  
    writer.WriteEndElement();  
}  
document.Save("book.xml");

保存 XML 文档

使用 XmlDocument 类的方法保存本主题中所述的方法对 XmlDocument 对象的更改。若要详细了解如何保存对 XmlDocument 对象所做的更改，请参阅保存和编写文档。

使用 XPathNavigator 插入 XML 数据

插入节点

插入同级节点

插入子节点

插入属性节点

复制节点

插入值

插入非类型化的值

插入类型化的值

InnerXml 和 OuterXml 属性

命名空间和 xml:lang 冲突

使用 XmlWriter 插入节点

不支持的 XmlWriter 方法

多个 XmlWriter 对象

保存 XML 文档

请参阅

反馈

其他资源