XPathNavigator.InsertElementBefore(String, String, String, String) 方法

定义

命名空间:

System.Xml.XPath

程序集:

System.Xml.ReaderWriter.dll

Source:

XPathNavigator.cs

使用通过指定值指定的命名空间前缀、本地名称和命名空间 URI 在当前节点之前创建一个新的同级元素。

public:
 virtual void InsertElementBefore(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);

public virtual void InsertElementBefore (string? prefix, string localName, string? namespaceURI, string? value);

abstract member InsertElementBefore : string * string * string * string -> unit
override this.InsertElementBefore : string * string * string * string -> unit

Public Overridable Sub InsertElementBefore (prefix As String, localName As String, namespaceURI As String, value As String)

参数

prefix

String

新的子元素的命名空间前缀（如果有）。

localName

String

新的子元素的本地名称（如果有）。

namespaceURI

String

新的子元素的命名空间 URI（如果有）。 Empty 与 null 等效。

value

String

新的子元素的值。 如果传递 Empty 或 null，将创建一个空元素。

例外

InvalidOperationException

位置 XPathNavigator 不允许在当前节点之前插入一个新的同级节点。

NotSupportedException

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->InsertElementBefore(navigator->Prefix, "pages", navigator->LookupNamespace(navigator->Prefix), "100");

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.InsertElementBefore(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100");

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.InsertElementBefore(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100")

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>  

注解

可以使用 或 LookupNamespace 方法获取LookupPrefix命名空间前缀和 URI 值。 例如，以下语法使用范围内的命名空间 xmlns:bk="http://www.contoso.com/books"插入同级元素：

navigator.InsertElementBefore(navigator.Prefix, "pages", LookupNamespaceURI(navigator.Prefix), String.Empty)  

这会创建新的同级 <bk:pages/> 元素。

以下是使用 InsertElementBefore 方法时要考虑的重要注意事项。

• 如果指定的命名空间前缀为 null 或 String.Empty，则新元素的命名空间 URI 的前缀将从范围内的当前命名空间中获取。 如果没有分配给当前范围内的指定命名空间 URI 的命名空间前缀，则自动生成命名空间前缀。

• InsertElementBefore仅当 定位在元素、文本、处理指令或注释节点上时XPathNavigator， 方法才有效。

• 方法 InsertElementBefore 不影响 的位置 XPathNavigator。