XPathNavigator.AppendChildElement(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 en ny underordnad elementnod i slutet av listan över underordnade noder i den aktuella noden med hjälp av namnområdesprefixet, det lokala namnet och namnområdes-URI:n som angetts med det angivna värdet.

public:
 virtual void AppendChildElement(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);
public virtual void AppendChildElement(string? prefix, string localName, string? namespaceURI, string? value);
public virtual void AppendChildElement(string prefix, string localName, string namespaceURI, string value);
abstract member AppendChildElement : string * string * string * string -> unit
override this.AppendChildElement : string * string * string * string -> unit
Public Overridable Sub AppendChildElement (prefix As String, localName As String, namespaceURI As String, value As String)

Parametrar

prefix
String

Namnområdesprefixet för den nya underordnade elementnoden (om någon).

localName
String

Det lokala namnet på den nya underordnade elementnoden (om någon).

namespaceURI
String

Namnområdes-URI:n för den nya underordnade elementnoden (om någon). Empty och null är likvärdiga.

value
String

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

Undantag

InvalidOperationException

Den aktuella noden som XPathNavigator är placerad på är inte rotnoden eller en elementnod.

NotSupportedException

Stöder XPathNavigator inte redigering.

Exempel

I följande exempel läggs ett nytt pages underordnat element till i 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.AppendChildElement(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.AppendChildElement(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

Om du lägger till en underordnad nod läggs den nya noden till i slutet av listan över underordnade noder för den aktuella noden. När det till exempel finns tre underordnade noder för en elementnod blir den bifogade noden den fjärde 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 metoden. Följande syntax lägger till ett underordnat element med hjälp av namnområdet i omfånget xmlns:bk=http://www.contoso.com/books:

navigator.AppendChildElement(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 AppendChildElement 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 AppendChildElement är endast giltig när XPathNavigator den är placerad på rotnoden eller en elementnod.

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

Gäller för