XPathNavigator.PrependChild Methode

Referenz

Definition

Namespace:: System.Xml.XPath

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens einen neuen untergeordneten Knoten.

Überlädt

PrependChild()	Gibt ein XmlWriter-Objekt zurück, mit dem am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens ein neuer untergeordneter Knoten erstellt werden kann.
PrependChild(String)	Erstellt unter Verwendung der angegebenen XML-Zeichenfolge am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens einen neuen untergeordneten Knoten.
PrependChild(XmlReader)	Erstellt unter Verwendung des XML-Inhalts des angegebenen XmlReader-Objekts am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens einen neuen untergeordneten Knoten.
PrependChild(XPathNavigator)	Erstellt unter Verwendung der Knoten im angegebenen XPathNavigator-Objekt am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens einen neuen untergeordneten Knoten.

PrependChild()

Gibt ein XmlWriter-Objekt zurück, mit dem am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens ein neuer untergeordneter Knoten erstellt werden kann.

public:
 virtual System::Xml::XmlWriter ^ PrependChild();

public virtual System.Xml.XmlWriter PrependChild ();

abstract member PrependChild : unit -> System.Xml.XmlWriter
override this.PrependChild : unit -> System.Xml.XmlWriter

Public Overridable Function PrependChild () As XmlWriter

Gibt zurück

XmlWriter

Ein XmlWriter-Objekt, mit dem am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens ein neuer untergeordneter Knoten erstellt werden kann.

Ausnahmen

InvalidOperationException

Der aktuelle Knoten, auf dem der XPathNavigator positioniert wird, lässt das Voranstellen eines neuen untergeordneten Knotens nicht zu.

NotSupportedException

Der XPathNavigator unterstützt keine Bearbeitung.

Beispiele

Im folgenden Beispiel wird ein neues pages untergeordnetes Element am Anfang der Liste untergeordneter Elemente des ersten book Elements in der contosoBooks.xml PrependChild Datei XmlWriter mit dem vom Methode zurückgegebenen Objekt vorgestellt.

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

XmlWriter^ pages = navigator->PrependChild();
pages->WriteElementString("pages", "100");
pages->Close();

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

XmlWriter pages = navigator.PrependChild();
pages.WriteElementString("pages", "100");
pages.Close();

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

Dim pages As XmlWriter = navigator.PrependChild()
pages.WriteElementString("pages", "100")
pages.Close()

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

Vor dem Ausstehen eines untergeordneten Knotens wird der Anfang der Liste untergeordneter Knoten für den aktuellen Knoten hinzugefügt. Wenn beispielsweise drei untergeordnete Knoten für ein Element vorhanden sind, wird der vordefinierte Knoten zum ersten untergeordneten Knoten. Wenn keine untergeordneten Knoten vorhanden sind, wird ein neuer untergeordneter Knoten erstellt.

Im Folgenden sind wichtige Hinweise zur Verwendung der PrependChild Methode zu berücksichtigen.

Der neue untergeordnete Knoten wird erst eingefügt, wenn die Close Methode des XmlWriter Objekts aufgerufen wird.
Die PrependChild Methode ist nur gültig, wenn die XPathNavigator Position auf einem Elementknoten erfolgt.
Die PrependChild Methode wirkt sich nicht auf die Position der XPathNavigator.

Gilt für

PrependChild(String)

Erstellt unter Verwendung der angegebenen XML-Zeichenfolge am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens einen neuen untergeordneten Knoten.

public:
 virtual void PrependChild(System::String ^ newChild);

public virtual void PrependChild (string newChild);

abstract member PrependChild : string -> unit
override this.PrependChild : string -> unit

Public Overridable Sub PrependChild (newChild As String)

Parameter

newChild: String

Die Zeichenfolge mit XML-Daten für den neuen untergeordneten Knoten.

Ausnahmen

ArgumentNullException

Der XML-Zeichenfolgenparameter ist null.

InvalidOperationException

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

NotSupportedException

Der XPathNavigator unterstützt keine Bearbeitung.

XmlException

Der XML-Zeichenfolgenparameter ist nicht ordnungsgemäß formatiert.

Beispiele

Im folgenden Beispiel wird ein neues pages untergeordnetes Element am Anfang der Liste untergeordneter Elemente des ersten book Elements in der contosoBooks.xml Datei vorgestellt.

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->PrependChild("<pages>100</pages>");

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.PrependChild("<pages>100</pages>");

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.PrependChild("<pages>100</pages>")

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

Um einen neuen Elementknoten zu erstellen, schließen Sie alle XML-Syntax im XML-Zeichenfolgenparameter ein. Die Zeichenfolge für einen neuen book Knoten ist PrependChild("<book/>"). Die Zeichenfolge zum Anfügen des Textbuchs an den Textknoten des aktuellen Knotens ist PrependChild("book"). Wenn die XML-Zeichenfolge mehrere Knoten enthält, werden alle Knoten hinzugefügt.

Im Folgenden sind wichtige Hinweise zur Verwendung der PrependChild Methode zu berücksichtigen.

Die PrependChild Methode ist nur gültig, wenn die XPathNavigator Position auf einem Elementknoten erfolgt.
Die PrependChild Methode wirkt sich nicht auf die Position der XPathNavigator.

Gilt für

PrependChild(XmlReader)

Erstellt unter Verwendung des XML-Inhalts des angegebenen XmlReader-Objekts am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens einen neuen untergeordneten Knoten.

public:
 virtual void PrependChild(System::Xml::XmlReader ^ newChild);

public virtual void PrependChild (System.Xml.XmlReader newChild);

abstract member PrependChild : System.Xml.XmlReader -> unit
override this.PrependChild : System.Xml.XmlReader -> unit

Public Overridable Sub PrependChild (newChild As XmlReader)

Parameter

newChild: XmlReader

Ein XmlReader-Objekt, das auf den XML-Daten für den neuen untergeordneten Knoten positioniert ist.

Ausnahmen

ArgumentException

Das XmlReader-Objekt befindet sich in einem Fehlerzustand oder wurde geschlossen.

ArgumentNullException

Der XmlReader-Objektparameter ist null.

InvalidOperationException

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

NotSupportedException

Der XPathNavigator unterstützt keine Bearbeitung.

XmlException

Der XML-Inhalt des XmlReader-Objektparameters ist nicht ordnungsgemäß formatiert.

Beispiele

Im folgenden Beispiel wird ein neues pages untergeordnetes Element am Anfang der Liste untergeordneter Elemente des ersten book Elements in der contosoBooks.xml Datei mit dem XmlReader angegebenen Objekt vorgestellt. Der http://www.contoso.com/books Namespace wird angegeben, damit das neue untergeordnete Element mit demselben Namespace wie das XML-Dokument vorgestellt wird.

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

XmlReader^ pages = XmlReader::Create(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator->PrependChild(pages);

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

XmlReader pages = XmlReader.Create(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator.PrependChild(pages);

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

Dim pages As XmlReader = XmlReader.Create(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))

navigator.PrependChild(pages)

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

Im Folgenden sind wichtige Hinweise zur Verwendung der PrependChild Methode zu berücksichtigen.

Wenn das XmlReader Objekt über eine Sequenz von XML-Knoten positioniert wird, werden alle Knoten in der Sequenz hinzugefügt.
Die PrependChild Methode ist nur gültig, wenn die XPathNavigator Position auf einem Elementknoten erfolgt.
Die PrependChild Methode wirkt sich nicht auf die Position der XPathNavigator.

Gilt für

PrependChild(XPathNavigator)

Erstellt unter Verwendung der Knoten im angegebenen XPathNavigator-Objekt am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens einen neuen untergeordneten Knoten.

public:
 virtual void PrependChild(System::Xml::XPath::XPathNavigator ^ newChild);

public virtual void PrependChild (System.Xml.XPath.XPathNavigator newChild);

abstract member PrependChild : System.Xml.XPath.XPathNavigator -> unit
override this.PrependChild : System.Xml.XPath.XPathNavigator -> unit

Public Overridable Sub PrependChild (newChild As XPathNavigator)

Parameter

newChild: XPathNavigator

Ein XPathNavigator-Objekt, das auf dem Knoten positioniert ist, der als neuer untergeordneter Knoten hinzugefügt werden soll.

Ausnahmen

ArgumentNullException

Der XPathNavigator-Objektparameter ist null.

InvalidOperationException

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

NotSupportedException

Der XPathNavigator unterstützt keine Bearbeitung.

Beispiele

Im folgenden Beispiel wird ein neues pages untergeordnetes Element am Anfang der Liste der untergeordneten Elemente des ersten book Elements in der contosoBooks.xml Datei mit dem in dem XPathNavigator angegebenen Objekt enthaltenen Knoten vorgestellt. Der http://www.contoso.com/books Namespace wird angegeben, damit das neue untergeordnete Element mit demselben Namespace wie das XML-Dokument vorgestellt wird.

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

XmlDocument^ childNodes = gcnew XmlDocument();
childNodes->Load(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator^ childNodesNavigator = childNodes->CreateNavigator();

navigator->PrependChild(childNodesNavigator);

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

XmlDocument childNodes = new XmlDocument();
childNodes.Load(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator childNodesNavigator = childNodes.CreateNavigator();

navigator.PrependChild(childNodesNavigator);

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

Dim childNodes As XmlDocument = New XmlDocument()
childNodes.Load(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))
Dim childNodesNavigator As XPathNavigator = childNodes.CreateNavigator()

navigator.PrependChild(childNodesNavigator)

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

Im Folgenden sind wichtige Hinweise zur Verwendung der PrependChild Methode zu berücksichtigen.

Wenn das XPathNavigator Objekt über eine Sequenz von XML-Knoten positioniert wird, werden alle Knoten in der Sequenz hinzugefügt.
Die PrependChild Methode ist nur gültig, wenn die XPathNavigator Position auf einem Elementknoten erfolgt.
Die PrependChild Methode wirkt sich nicht auf die Position der XPathNavigator.

Gilt für

XPathNavigator.PrependChild Methode

Definition

Überlädt

PrependChild()

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für

PrependChild(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für

PrependChild(XmlReader)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für

PrependChild(XPathNavigator)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für

Zusätzliche Ressourcen