Auf Englisch lesen

Teilen über


XPathNavigator.WriteSubtree(XmlWriter) Methode

Definition

Übergibt den aktuellen Knoten und dessen untergeordnete Knoten als Stream an das angegebene XmlWriter-Objekt.

C#
public virtual void WriteSubtree(System.Xml.XmlWriter writer);

Parameter

writer
XmlWriter

Das XmlWriter-Objekt, an das die Daten übergeben werden sollen.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der WriteSubtree -Methode für das erste book Element der contosoBooks.xml Datei.

C#
XPathDocument document = new XPathDocument("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");

XmlWriter writer = XmlWriter.Create("contosoBook.xml");
navigator.WriteSubtree(writer);

writer.Close();

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

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

Namespacedeklarationen für die Bereichsnamespaces des aktuellen Knotens werden in den XML-Stream eingefügt, der an das XmlWriter angegebene Objekt gestreamt wird.

Wenn die WriteSubtree -Methode beispielsweise für das erste book Element der books.xml Datei aufgerufen wird, wird die http://www.contoso.com/books Namespacedeklaration am Anfang des XML-Dokuments im XML-Stream an das XmlWriter angegebene Objekt gestreamt, wie im folgenden Beispiel gezeigt.

XML
<?xml version="1.0" encoding="utf-8"?>  
<book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0" xmlns="http://www.contoso.com/books">  
    <title>The Autobiography of Benjamin Franklin</title>  
    <author>  
        <first-name>Benjamin</first-name>  
        <last-name>Franklin</last-name>  
    </author>  
    <price>8.99</price>  
</book>  

Hinweis

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

Gilt für:

Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1