XPathNavigator.InsertElementBefore(String, String, String, String) Metod

Definition

Namnområde:
System.Xml.XPath
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.XPath.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll
Källa:
XPathNavigator.cs
Källa:
XPathNavigator.cs
Källa:
XPathNavigator.cs
Källa:
XPathNavigator.cs
Källa:
XPathNavigator.cs

Skapar ett nytt syskonelement före den aktuella noden med hjälp av namnområdesprefixet, det lokala namnet och den angivna namnområdes-URI:n med det angivna värdet.

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)

Parametrar

prefix
String

Namnområdesprefixet för det nya underordnade elementet (om det finns något).

localName
String

Det lokala namnet på det nya underordnade elementet (om det finns något).

namespaceURI
String

Namnområdes-URI:n för det nya underordnade elementet (om det finns något). Empty och null är likvärdiga.

value
String

Värdet för det nya underordnade elementet. Om Empty eller null skickas skapas ett tomt element.

Undantag

InvalidOperationException

Positionen för XPathNavigator tillåter inte att en ny syskonnod infogas före den aktuella noden.

NotSupportedException

Stöder XPathNavigator inte redigering.

Exempel

I följande exempel infogas ett nytt pages-element före det price-underordnade elementet till det första book-elementet i contosoBooks.xml-filen.

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)

Exemplet tar contosoBooks.xml filen som indata.

<?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>

Kommentarer

Namnområdesprefix och URI-värden kan hämtas med hjälp av LookupPrefix metoden eller LookupNamespace . Följande syntax infogar till exempel ett syskonelement med hjälp av namnområdet i omfånget xmlns:bk="http://www.contoso.com/books":

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

Detta skapar det nya syskonelementet <bk:pages/> .

Följande är viktiga att tänka på när du använder InsertElementBefore metoden.

  • Om det angivna namnområdesprefixet är null eller String.Emptyhämtas prefixet för namnområdes-URI:n för det nya elementet från de aktuella namnrymderna i omfånget. Om det inte finns något namnområdesprefix tilldelat till den angivna namnområdes-URI:n i det aktuella omfånget genereras automatiskt ett namnområdesprefix.

  • Metoden InsertElementBefore är endast giltig när XPathNavigator är placerad på ett element, text, bearbetningsinstruktion eller kommentarsnod.

  • Metoden InsertElementBefore påverkar inte positionen för XPathNavigator.

Gäller för