XmlWriter.WriteAttributes メソッド

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

XmlWriter.WriteAttributes メソッド

派生クラスによってオーバーライドされると、XmlReader の現在の位置で見つかったすべての属性を書き込みます。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

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

instance.WriteAttributes(reader, defattr)

C#

public virtual void WriteAttributes (
    XmlReader reader,
    bool defattr
)

C++

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

J#

public void WriteAttributes (
    XmlReader reader, 
    boolean defattr
)

JScript

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

パラメータ

reader

属性のコピー元の XmlReader。

defattr

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

例外

例外の種類	条件
ArgumentNullException	reader が null 参照 (Visual Basic では Nothing) です。
XmlException	リーダーが element ノード、attribute ノード、または XmlDeclaration ノードに配置されていません。

解説

リーダーが element ノードに配置されている場合、WriteAttributes は、格納されているすべての属性をコピーします。リーダーが attribute ノードに配置されている場合、このメソッドは、現在の属性を書き込み、次に残りの属性を要素の終了タグまで書き込みます。リーダーが XmlDeclaration ノードに配置されている場合、このメソッドは、宣言内のすべての属性を書き込みます。リーダーが他のノード型に配置されている場合、このメソッドは XmlException をスローします。

整形式の XML を確認するために、XmlValidatingReader を使用してこのメソッドを呼び出すと、無効なドキュメントになる可能性がある内容 (エンティティから展開された内容) は、書き込み時に置き換えられます。たとえば、展開された > エンティティが属性に含まれている場合、整形式のドキュメントを確認するために、展開された > は、書き込み時に > に置き換えられます。

使用例

すべての要素を出力にコピーし、タグ名を大文字に変更し、変更されていない属性をすべてコピーする例を次に示します。

Visual Basic

Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
  Public Shared Sub Main()

    Dim reader As XmlReader = XmlReader.Create("test1.xml")
    Dim settings As XmlWriterSettings = new
 XmlWriterSettings()
    settings.Indent = true
    Dim writer As XmlWriter = XmlWriter.Create(Console.Out)
        
      While reader.Read()
          If reader.NodeType = XmlNodeType.Element Then
              writer.WriteStartElement(reader.Name.ToUpper())
              writer.WriteAttributes(reader, False)
              If reader.IsEmptyElement Then
                 writer.WriteEndElement()
              End If
          Else
              If reader.NodeType = XmlNodeType.EndElement Then
                  writer.WriteEndElement()
              End If
          End If
      End While
      writer.Close()
      reader.Close()

    End Sub 'Main
End Class 'Sample

C#

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

public class Sample {

  public static void Main()
 {
 
    XmlReader reader = XmlReader.Create("test1.xml");
    XmlWriterSettings settings = new XmlWriterSettings();
    settings.Indent = true;
    XmlWriter writer = XmlWriter.Create(Console.Out);

    while (reader.Read()) {
      if (reader.NodeType == XmlNodeType.Element) {
        writer.WriteStartElement(reader.Name.ToUpper());
        writer.WriteAttributes(reader, false);
        if (reader.IsEmptyElement) writer.WriteEndElement();
      }
      else if (reader.NodeType == XmlNodeType.EndElement)
 {
        writer.WriteEndElement();
      }
    }
    writer.Close();
    reader.Close();
  }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlReader^ reader = XmlReader::Create( L"test1.xml" );
   XmlWriterSettings^ settings = gcnew XmlWriterSettings;
   settings->Indent = true;
   XmlWriter^ writer = XmlWriter::Create( Console::Out );
   while ( reader->Read() )
   {
      if ( reader->NodeType == XmlNodeType::Element )
      {
         writer->WriteStartElement( reader->Name->ToUpper() );
         writer->WriteAttributes( reader, false );
         if ( reader->IsEmptyElement )
                  writer->WriteEndElement();
      }
      else
      if ( reader->NodeType == XmlNodeType::EndElement )
      {
         writer->WriteEndElement();
      }
   }

   writer->Close();
   reader->Close();
}

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

<test a="1" b="2">
    <item c="3" d="4"
 e="5" f="6"/>
</test>

プラットフォーム

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 の書き方