XmlWriter.WriteNodeとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

XmlWriter.WriteNode メソッド (XmlReader, Boolean)

派生クラスでオーバーライドされると、リーダーのデータをすべてライタにコピーし、リーダーを次の兄弟の開始位置に移動します。

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

Visual Basic (宣言)

Public Overridable Sub WriteNode
 ( _
    reader As XmlReader, _
    defattr As Boolean _
)

Visual Basic (使用法)

Dim instance As XmlWriter
Dim reader As XmlReader
Dim defattr As Boolean

instance.WriteNode(reader, defattr)

public virtual void WriteNode (
    XmlReader reader,
    bool defattr
)

C++

public:
virtual void WriteNode (
    XmlReader^ reader, 
    bool defattr
)

public void WriteNode (
    XmlReader reader, 
    boolean defattr
)

JScript

public function WriteNode (
    reader : XmlReader, 
    defattr : boolean
)

パラメータ

reader: 読み取り元の XmlReader。

defattr: XmlReader の既定の属性をコピーする場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	reader が null 参照 (Visual Basic では Nothing) です。

解説

このメソッドでサポートされるノード型を次の表に示します。

ノード型	WriteNode の動作
None	型に関係なく、すべてのノードを書き込みます。つまり、ライタは、属性、処理命令、コメントなどを含め、XmlReader を使用して読み取ったすべてのノードを書き込みます。この状況は、XmlReader が初期状態にあると発生します (XmlReader.ReadState プロパティが ReaderState.Initial を返すとき)。
Element	要素ノードと任意の属性ノードを書き込みます。
Attribute	操作なし。代わりに、WriteStartAttribute または WriteAttributeString を使用します。
Text	テキストノードを書き込みます。
CDATA	CDATA セクションノードを書き込みます。
EntityReference	エンティティ参照ノードを書き込みます。
ProcessingInstruction	処理命令ノードを書き込みます。
Comment	コメントノードを書き込みます。
DocumentType	ドキュメント型ノードを書き込みます。
SignificantWhitespace	有意な空白ノードを書き込みます。
Whitespace	空白ノードを書き込みます。
EndElement	要素終了タグを書き込みます。
EndEntity	操作なし。
XmlDeclaration	XML 宣言ノードを書き込みます。

リーダーが初期状態の場合、このメソッドはリーダーをファイルの末尾に移動します。リーダーが既にファイルの末尾にあるか、終了状態の場合、このメソッドは機能しません。

次の C# コードは、XML 入力ドキュメント全体をコンソールにコピーします。

XmlReader reader = XmlReader.Create(myfile);
XmlWriter writer = XmlWriter.Create(Console.Out);
writer.WriteNode(reader, false);

ルートノードから離れてドキュメント内の別の場所にいる場合、次の C# の例は、ノードを正しく書き込みます。

XmlReader reader = XmlReader.Create(myfile);
reader.Read(); // Read PI
reader.Read(); // Read Comment
reader.Read(); // Read DOCType
XmlWriter writer = XmlWriter.Create(Console.Out);
while (!reader.EOF){
  writer.WriteNode(reader, false);
 }

リーダーが空白を返すように構成され、ライタが出力をインデント設定するように構成されていると、WriteNode は予期しない出力を生成する場合があります。基本的に、二重の書式指定が生成されます。

使用例

最初と最後の Book ノードをコンソールに書き込む例を次に示します。

Visual Basic

Imports System
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    Dim reader as XmlTextReader = new
 XmlTextReader("books.xml")
    reader.WhitespaceHandling = WhitespaceHandling.None

    'Move the reader to the first book element.
    reader.MoveToContent()
    reader.Read()

    'Create a writer that outputs to the console.
    Dim writer as XmlTextWriter = new
 XmlTextWriter (Console.Out)
    writer.Formatting = Formatting.Indented
    
    'Write the start tag.
    writer.WriteStartElement("myBooks")

    'Write the first book.
    writer.WriteNode(reader, false)

    'Skip the second book.
    reader.Skip()

    'Write the last book.
    writer.WriteNode(reader, false)
    writer.WriteEndElement()

    'Close the writer and the reader.
    writer.Close()
    reader.Close()

  end sub
end class

using System;
using System.IO;
using System.Xml;

public class Sample{

  public static void Main(){

    XmlTextReader reader = new XmlTextReader("books.xml");
    reader.WhitespaceHandling = WhitespaceHandling.None;

    //Move the reader to the first book element.
    reader.MoveToContent();
    reader.Read();

    //Create a writer that outputs to the console.
    XmlTextWriter writer = new XmlTextWriter (Console.Out);
    writer.Formatting = Formatting.Indented;
    
    //Write the start tag.
    writer.WriteStartElement("myBooks");

    //Write the first book.
    writer.WriteNode(reader, false);

    //Skip the second book.
    reader.Skip();

    //Write the last book.
    writer.WriteNode(reader, false);
    writer.WriteEndElement();

    //Close the writer and the reader.
    writer.Close();
    reader.Close();

  }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextReader^ reader = gcnew XmlTextReader( "books.xml" );
   reader->WhitespaceHandling = WhitespaceHandling::None;
   
   // Move the reader to the first book element.
   reader->MoveToContent();
   reader->Read();
   
   // Create a writer that outputs to the console.
   XmlTextWriter^ writer = gcnew XmlTextWriter( Console::Out );
   writer->Formatting = Formatting::Indented;
   
   // Write the start tag.
   writer->WriteStartElement( "myBooks" );
   
   // Write the first book.
   writer->WriteNode( reader, false );
   
   // Skip the second book.
   reader->Skip();
   
   // Write the last book.
   writer->WriteNode( reader, false );
   writer->WriteEndElement();
   
   // Close the writer and the reader.
   writer->Close();
   reader->Close();
}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        XmlTextReader reader = new XmlTextReader("books.xml");
        reader.set_WhitespaceHandling(WhitespaceHandling.None);
        //Move the reader to the first book element.
        reader.MoveToContent();
        reader.Read();
        //Create a writer that outputs to the console.
        XmlTextWriter writer = new XmlTextWriter(Console.get_Out());
        writer.set_Formatting(Formatting.Indented);
        //Write the start tag.
        writer.WriteStartElement("myBooks");
        //Write the first book.
        writer.WriteNode(reader, false);
        //Skip the second book.
        reader.Skip();
        //Write the last book.
        writer.WriteNode(reader, false);
        writer.WriteEndElement();
        //Close the writer and the reader.
        writer.Close();
        reader.Close();
    } //main 
} //Sample

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

<bookstore>
  <book genre="autobiography"
 publicationdate="1981" 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"
 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"
 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 CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlWriter クラス
XmlWriter メンバ
System.Xml 名前空間
その他の技術情報
XmlWriter による XML の書き方
XmlWriter による XML の書き方

XmlWriter.WriteNode メソッド

ソースオブジェクトから現在のライタのインスタンスにすべてをコピーします。
オーバーロードの一覧

名前	説明
XmlWriter.WriteNode (XmlReader, Boolean)	派生クラスでオーバーライドされると、リーダーのデータをすべてライタにコピーし、リーダーを次の兄弟の開始位置に移動します。 .NET Compact Framework によってサポートされています。
XmlWriter.WriteNode (XPathNavigator, Boolean)	XPathNavigator オブジェクトからライタにすべてをコピーします。XPathNavigator の位置は変更されません。

参照

その他の技術情報

XmlWriter による XML の書き方
XmlWriter による XML の書き方

XmlWriter による XML の書き方

XmlWriter.WriteNode メソッド (XPathNavigator, Boolean)

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

XPathNavigator オブジェクトからライタにすべてをコピーします。XPathNavigator の位置は変更されません。

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

Visual Basic (宣言)

Public Overridable Sub WriteNode
 ( _
    navigator As XPathNavigator, _
    defattr As Boolean _
)

Visual Basic (使用法)

Dim instance As XmlWriter
Dim navigator As XPathNavigator
Dim defattr As Boolean

instance.WriteNode(navigator, defattr)

public virtual void WriteNode (
    XPathNavigator navigator,
    bool defattr
)

C++

public:
virtual void WriteNode (
    XPathNavigator^ navigator, 
    bool defattr
)

public void WriteNode (
    XPathNavigator navigator, 
    boolean defattr
)

JScript

public function WriteNode (
    navigator : XPathNavigator, 
    defattr : boolean
)

パラメータ

navigator: コピー元の XPathNavigator。

defattr: 既定の属性をコピーする場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	navigator が null 参照 (Visual Basic では Nothing) です。

解説

このメソッドでサポートされる XPath ノード型を次の表に示します。

XPathNodeType	WriteNode の動作
Root	型に関係なく、すべてのノードを書き込みます。つまり、ライタは XPathNavigator を使用して、ルートノードからすべてのノードを書き込みます (属性、処理命令、コメントなど)。
Element	要素ノードと任意の属性ノードを書き込みます。
Attribute	操作なし。代わりに、WriteStartAttribute または WriteAttributeString を使用します。
Text	テキストノードを書き込みます。
Namespace	操作なし。名前空間宣言を書き込むには、WriteStartAttribute メソッドまたは WriteAttributeString メソッドを使用します。
ProcessingInstruction	処理命令ノードを書き込みます。
Comment	コメントノードを書き込みます。
SignificantWhitespace	有意な空白ノードを書き込みます。
Whitespace	空白ノードを書き込みます。