XPathNavigator.AppendChild 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

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 einen neuen untergeordneten Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens.

Überlädt

Name	Beschreibung
AppendChild()	Gibt ein XmlWriter Objekt zurück, das zum Erstellen eines oder mehrerer neuer untergeordneter Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens verwendet wird.
AppendChild(String)	Erstellt einen neuen untergeordneten Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe der angegebenen XML-Datenzeichenfolge.
AppendChild(XmlReader)	Erstellt einen neuen untergeordneten Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe des XML-Inhalts des XmlReader angegebenen Objekts.
AppendChild(XPathNavigator)	Erstellt einen neuen untergeordneten Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe der Knoten im XPathNavigator angegebenen.

AppendChild()

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Gibt ein XmlWriter Objekt zurück, das zum Erstellen eines oder mehrerer neuer untergeordneter Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens verwendet wird.

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

public virtual System.Xml.XmlWriter AppendChild();

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

Public Overridable Function AppendChild () As XmlWriter

Gibt zurück

XmlWriter

Ein XmlWriter Objekt, das zum Erstellen neuer untergeordneter Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens verwendet wird.

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

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.AppendChild();
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.AppendChild()
pages.WriteElementString("pages", "100")
pages.Close()

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 untergeordneter Knoten werden die neuen Knoten am Ende 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 erste angefügte Knoten zum vierten untergeordneten Knoten. Wenn keine untergeordneten Knoten vorhanden sind, wird ein neuer untergeordneter Knoten erstellt.

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

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

Sie können mehr als einen Knoten in den Writer schreiben. Alle Knoten werden am Ende der Liste der untergeordneten Knoten des aktuellen Knotens angefügt.

Gilt für:

AppendChild(String)

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Erstellt einen neuen untergeordneten Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe der angegebenen XML-Datenzeichenfolge.

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

public virtual void AppendChild(string newChild);

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

Public Overridable Sub AppendChild (newChild As String)

Parameter

newChild: String

Die XML-Datenzeichenfolge für den neuen untergeordneten Knoten.

Ausnahmen

ArgumentNullException

Der XML-Datenzeichenfolgenparameter lautet null.

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.

XmlException

Der XML-Datenzeichenfolgenparameter ist nicht wohlgeformt.

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

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 ein Element vorhanden sind, wird der angefügte Knoten zum vierten untergeordneten Knoten. Wenn keine untergeordneten Knoten vorhanden sind, wird ein neuer untergeordneter Knoten erstellt.

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

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

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

Gilt für:

AppendChild(XmlReader)

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Erstellt einen neuen untergeordneten Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe des XML-Inhalts des XmlReader angegebenen Objekts.

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

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

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

Public Overridable Sub AppendChild (newChild As XmlReader)

Parameter

newChild: XmlReader

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

Ausnahmen

ArgumentException

Das XmlReader Objekt befindet sich in einem Fehlerzustand oder geschlossen.

ArgumentNullException

Der XmlReader Objektparameter ist null.

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.

XmlException

Der XML-Inhalt des XmlReader Objektparameters ist nicht wohlgeformt.

Beispiele

Im folgenden Beispiel wird ein neues pages untergeordnetes Element mithilfe des book angegebenen Objekts an die Liste der untergeordneten Elemente des ersten contosoBooks.xml Elements in der XmlReader Datei angefügt. Der http://www.contoso.com/books Namespace wird angegeben, sodass das neue untergeordnete Element mit demselben Namespace wie das XML-Dokument angefügt wird.

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.AppendChild(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.AppendChild(pages)

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

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

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

Gilt für:

AppendChild(XPathNavigator)

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Erstellt einen neuen untergeordneten Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe der Knoten im XPathNavigator angegebenen.

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

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

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

Public Overridable Sub AppendChild (newChild As XPathNavigator)

Parameter

newChild: XPathNavigator

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

Ausnahmen

ArgumentNullException

Der XPathNavigator Objektparameter ist null.

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, wobei der im XPathNavigator angegebenen Knoten enthaltene Knoten verwendet wird. Der http://www.contoso.com/books Namespace wird angegeben, sodass das neue untergeordnete Element mit demselben Namespace wie das XML-Dokument angefügt wird.

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

if(childNodesNavigator.MoveToChild("pages", "http://www.contoso.com/books"))
{
    navigator.AppendChild(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()

If childNodesNavigator.MoveToChild("pages", "http://www.contoso.com/books") Then
    navigator.AppendChild(childNodesNavigator)
End If

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

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

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

Gilt für:

Feedback

War diese Seite hilfreich?