XPathNavigator.WriteSubtree(XmlWriter) Methode

Referenz

Definition

Namespace:: System.Xml.XPath

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

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.

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

public:
 virtual void WriteSubtree(System::Xml::XmlWriter ^ writer);

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

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

Public Overridable Sub WriteSubtree (writer As XmlWriter)

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.

    XPathDocument^ document = gcnew 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();

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

Dim document As XPathDocument = New XPathDocument("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 writer As XmlWriter = XmlWriter.Create("contosoBook.xml")
navigator.WriteSubtree(writer)

writer.Close()

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

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 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:

Freigeben über