XPathNavigator.AppendChildElement(String, String, String, String) Methode

Definition

Namespace:

System.Xml.XPath

Assembly:

System.Xml.ReaderWriter.dll

Source:

XPathNavigator.cs

Erstellt am Ende der Liste mit untergeordneten Knoten des aktuellen Knotens einen neuen untergeordneten Elementknoten mit dem angegebenen Wert. Dabei werden die angegebenen Werte für das Namespacepräfix, den lokalen Namen und den Namespace-URI verwendet.

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);

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)

Parameter

prefix

String

Das Namespacepräfix des neuen untergeordneten Elementknotens (sofern vorhanden).

localName

String

Der lokale Name des neuen untergeordneten Elementknotens (sofern vorhanden).

namespaceURI

String

Der Namespace-URI des neuen untergeordneten Elementknotens (sofern vorhanden). Empty und null sind gleichwertig.

value

String

Der Wert des neuen untergeordneten Elementknotens. Beim Übergeben von Empty oder null wird ein leeres Element erstellt.

Ausnahmen

InvalidOperationException

Der aktuelle Knoten, auf dem sich der XPathNavigator befindet, ist weder der Stammknoten noch ein Elementknoten.

NotSupportedException

Der XPathNavigator unterstützt keine Bearbeitung.

Beispiele

Im folgenden Beispiel wird der Liste mit untergeordneten Elementen des ersten pages-Elements in der Datei book ein neues untergeordnetes contosoBooks.xml-Element angefügt.

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

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.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)

In diesem Beispiel wird die Datei contosoBooks.xml als Eingabe verwendet.

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

Hinweise

Durch das Anfügen eines untergeordneten Knotens wird der neue Knoten am Ende der Liste der untergeordneten Knoten für den aktuellen Knoten hinzugefügt. Wenn beispielsweise drei untergeordnete Knoten für einen Elementknoten vorhanden sind, wird der angefügte Knoten zum vierten untergeordneten Knoten. Wenn keine untergeordneten Knoten vorhanden sind, wird ein neuer untergeordneter Knoten erstellt.

Namespacepräfix- und URI-Werte können mithilfe der LookupPrefix -Methode oder der LookupNamespace -Methode abgerufen werden. Die folgende Syntax fügt z. B. ein untergeordnetes Element mithilfe des bereichsinternen Namespace xmlns:bk=http://www.contoso.com/booksan:

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

Dadurch wird das neue untergeordnete <bk:pages/> Element erstellt.

Im Folgenden finden Sie wichtige Hinweise, die Sie bei der Verwendung der AppendChildElement -Methode berücksichtigen sollten.

• Wenn das angegebene Namespacepräfix oder String.Emptyistnull, wird das Präfix für den Namespace-URI des neuen Elements aus den aktuellen Namespaces im Gültigkeitsbereich abgerufen. Wenn dem angegebenen Namespace-URI im aktuellen Bereich kein Namespacepräfix zugewiesen ist, wird automatisch ein Namespacepräfix generiert.

• Die AppendChildElement -Methode ist nur gültig, wenn auf XPathNavigator dem Stammknoten oder einem Elementknoten positioniert ist.

• Die AppendChildElement -Methode wirkt sich nicht auf die Position von aus XPathNavigator.