XPathNavigator.PrependChildElement(String, String, String, String) Metod

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

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

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

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

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

Parametrar

Undantag

Exempel

I följande exempel förbereds ett nytt pages underordnat element i början av listan över underordnade element i det första book elementet contosoBooks.xml i 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.PrependChildElement(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100");

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

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

I väntan på en underordnad nod läggs den nya noden till i början av listan över underordnade noder för den aktuella noden. När det till exempel finns tre underordnade noder för ett element blir den förberedda noden den första underordnade noden. Om det inte finns några underordnade noder skapas en ny underordnad nod.

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

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

Detta skapar det nya underordnade <bk:pages/> elementet.

Följande är viktiga att tänka på när du använder PrependChildElement 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 PrependChildElement är endast giltig när den XPathNavigator är placerad på en elementnod.

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