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

定义

命名空间:
System.Xml.XPath
程序集:
netstandard.dll, System.Xml.ReaderWriter.dll
程序集:
System.Xml.XPath.dll
程序集:
System.Xml.ReaderWriter.dll
程序集:
System.Xml.dll
程序集:
netstandard.dll
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
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);
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 = 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>

注解

可以使用或LookupPrefix方法获取LookupNamespace命名空间前缀和 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方法的位置。

适用于