XPathNavigator.PrependChildElement(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 ein neues untergeordnetes Element am Anfang 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 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)

Parameter

prefix
String

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

localName
String

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

namespaceURI
String

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

value
String

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

Ausnahmen

InvalidOperationException

Der aktuelle Knoten, auf dem sich die XPathNavigator Position befindet, lässt nicht zu, dass ein neuer untergeordneter Knoten vorangestellt wird.

NotSupportedException

Die XPathNavigator Bearbeitung wird nicht unterstützt.

Beispiele

Im folgenden Beispiel wird ein neues pages untergeordnetes Element dem Anfang der Liste der untergeordneten Elemente des ersten book Elements in der contosoBooks.xml Datei vorangestellt.

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)

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

Bevor ein untergeordneter Knoten aussteht, wird der neue Knoten am Anfang der Liste der untergeordneten Knoten für den aktuellen Knoten hinzugefügt. Wenn beispielsweise drei untergeordnete Knoten für ein Element vorhanden sind, wird der vorangestellte Knoten zum ersten untergeordneten Knoten. Wenn keine untergeordneten Knoten vorhanden sind, wird ein neuer untergeordneter Knoten erstellt.

Namespacepräfix- und URI-Werte können mithilfe der LookupPrefix Oder-Methode LookupNamespace abgerufen werden. Die folgende Syntax stellt z. B. ein untergeordnetes Element mithilfe des Namespaces im Bereich xmlns:bk="http://www.contoso.com/books"voran:

navigator.PrependChildElement(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 PrependChildElement 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 PrependChildElement Methode ist nur gültig, wenn die XPathNavigator Methode auf einem Elementknoten positioniert wird.

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

Gilt für: