XPathNavigator.WriteSubtree メソッド

.NET Framework クラス ライブラリ リファレンス

XPathNavigator.WriteSubtree メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在のノードとその子ノードを、指定された XmlWriter オブジェクトにストリーム転送します。

名前空間: System.Xml.XPath
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub WriteSubtree
 ( _
    writer As XmlWriter _
)

Visual Basic (使用法)

Dim instance As XPathNavigator
Dim writer As XmlWriter

instance.WriteSubtree(writer)

C#

public virtual void WriteSubtree (
    XmlWriter writer
)

C++

public:
virtual void WriteSubtree (
    XmlWriter^ writer
)

J#

public void WriteSubtree (
    XmlWriter writer
)

JScript

public function WriteSubtree (
    writer : XmlWriter
)

パラメータ

writer

ストリーム転送先の XmlWriter オブジェクト。

戻り値
現在のノードとその子ノードが格納された XmlWriter。

解説

現在のノードのスコープ内の名前空間に対する名前空間宣言が、指定した XmlWriter オブジェクトにストリーム転送される XML に挿入されます。

たとえば次の例に示すように、books.xml ファイルの最初の book 要素で WriteSubtree メソッドが呼び出された場合、指定した XmlWriter オブジェクトにストリーム転送される XML に、XML ドキュメントの先頭で行われている http://www.contoso.com/books 名前空間宣言が挿入されます。

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

メモ
WriteSubtree メソッドは、XPathNavigator の位置に影響を与えません。

使用例

contosoBooks.xml ファイルの最初の book 要素の WriteSubtree メソッドを使用する例を次に示します。

Visual Basic

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

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

この例では、入力として、contosoBooks.xml というファイルを使用しています。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XPathNavigator クラス
XPathNavigator メンバ
System.Xml.XPath 名前空間