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

Definition

Namespace:
System.Xml.XPath
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XPath.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Quelle:
XPathNavigator.cs
Quelle:
XPathNavigator.cs
Quelle:
XPathNavigator.cs
Quelle:
XPathNavigator.cs
Quelle:
XPathNavigator.cs

Erstellt einen neuen untergeordneten Elementknoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe des Namespacepräfixes, des lokalen Namens und des Namespace-URI, der mit dem angegebenen Wert angegeben ist.

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)

Parameter

prefix
String

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

localName
String

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

namespaceURI
String

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

value
String

Der Wert des neuen untergeordneten Elementknotens. Wenn Empty oder null übergeben wird, wird ein leeres Element erstellt.

Ausnahmen

InvalidOperationException

Der aktuelle Knoten, auf dem sich die XPathNavigator Position befindet, ist nicht der Stammknoten oder ein Elementknoten.

NotSupportedException

Die XPathNavigator Bearbeitung wird nicht unterstützt.

Beispiele

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

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)

Im Beispiel wird die contosoBooks.xml Datei 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 Namespaces im Bereich 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.

  • Ist das angegebene Namespacepräfix oder nullString.Empty, 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 die XPathNavigator Position auf dem Stammknoten oder einem Elementknoten erfolgt.

  • Die AppendChildElement Methode wirkt sich nicht auf die Position der XPathNavigator.

Gilt für: