XMLWriter

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

XmlWriter クラス

XML データが格納されたストリームまたはファイルを、高速かつ非キャッシュで前方向に生成する方法を提供するライタを表します。

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

Visual Basic (宣言)

Public MustInherit Class
 XmlWriter
    Implements IDisposable

Visual Basic (使用法)

Dim instance As XmlWriter

C#

public abstract class XmlWriter : IDisposable

C++

public ref class XmlWriter abstract : IDisposable

J#

public abstract class XmlWriter implements
 IDisposable

JScript

public abstract class XmlWriter implements
 IDisposable

解説

XmlWriter クラスは、W3C 勧告『Extensible Markup Language (XML) 1.0』および勧告『Namespaces in XML』をサポートします。

メモ
Microsoft .NET Framework には、XmlWriter クラスの実装である XmlTextWriter クラスが含まれていますが、2.0 リリースでは、新しい XmlWriter オブジェクトを作成する場合、Create メソッドを使用することをお勧めします。Create メソッドを使用すると、作成した XmlWriter オブジェクトでサポートする機能を指定できます。また、2.0 リリースで導入されたすべての新機能も十分に活用できます。

XmlWriter クラスの詳細については、XmlWriter による XML の書き方 のトピックを参照してください。

セキュリティについての考慮事項

XmlWriter クラスを使用する際の考慮事項を次に示します。

• XmlWriter によって例外がスローされると、本来アプリケーションには表示されてはならないパス情報が開示されてしまう可能性があります。アプリケーションで例外をキャッチし、適切に処理する必要があります。

• XmlWriter は、WriteDocType メソッドまたは WriteRaw メソッドに渡されるデータの検証を行いません。これらのメソッドに任意のデータを渡さないでください。

継承階層

System.Object
  System.Xml.XmlWriter
     System.Xml.XmlTextWriter
     System.Xml.Xsl.Runtime.XmlQueryOutput

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 メンバ
System.Xml 名前空間
その他の技術情報
XML ドキュメントと XML データ
セキュリティと System.Xml アプリケーション

XmlWriter コンストラクタ

XmlWriter クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New XmlWriter

C#

protected XmlWriter ()

C++

protected:
XmlWriter ()

J#

protected XmlWriter ()

JScript

protected function XmlWriter ()

プラットフォーム

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 プロパティ

パブリック プロパティ

	名前	説明
	XmlSpace	派生クラスでオーバーライドされると、現在の xml:space スコープを表す XmlSpace を取得します。

参照

関連項目

XmlWriter クラス
System.Xml 名前空間

その他の技術情報

XML ドキュメントと XML データ
セキュリティと System.Xml アプリケーション

XmlWriter メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Close	派生クラスでオーバーライドされると、このストリームと基になるストリームを閉じます。
	Create	オーバーロードされます。 新しい XmlWriter インスタンスを作成します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Flush	派生クラスでオーバーライドされると、バッファ内のデータをすべて基になるストリームにフラッシュし、基になるストリームもフラッシュします。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	LookupPrefix	派生クラスでオーバーライドされると、名前空間 URI の現在の名前空間スコープで定義された最も近いプリフィックスを返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	WriteAttributes	派生クラスによってオーバーライドされると、XmlReader の現在の位置で見つかったすべての属性を書き込みます。
	WriteAttributeString	オーバーロードされます。 派生クラスでオーバーライドされると、指定した値の属性を書き込みます。
	WriteBase64	派生クラスでオーバーライドされると、指定したバイナリ バイトを Base64 としてエンコードし、その結果生成されるテキストを書き込みます。
	WriteBinHex	派生クラスでオーバーライドされると、指定されたバイナリ バイトを BinHex としてエンコードし、その結果生成されるテキストを書き込みます。
	WriteCData	派生クラスでオーバーライドされると、指定したテキストを含む <![CDATA[...]]> ブロックを書き込みます。
	WriteCharEntity	派生クラスでオーバーライドされると、指定した Unicode 文字値の文字エンティティを強制的に生成します。
	WriteChars	派生クラスでオーバーライドされると、一度に 1 つのバッファにテキストを書き込みます。
	WriteComment	派生クラスでオーバーライドされると、指定したテキストを格納している <!--...--> コメントを書き込みます。
	WriteDocType	派生クラスでオーバーライドされると、指定した名前とオプションの属性を含む DOCTYPE 宣言を書き込みます。
	WriteElementString	オーバーロードされます。 派生クラスでオーバーライドされると、文字列値を含む要素を書き込みます。
	WriteEndAttribute	派生クラスでオーバーライドされると、前の WriteStartAttribute 呼び出しを閉じます。
	WriteEndDocument	派生クラスでオーバーライドされると、開いている任意の要素または属性を閉じ、ライタを Start 状態に戻します。
	WriteEndElement	派生クラスでオーバーライドされると、1 つの要素を閉じ、対応する名前空間スコープをポップします。
	WriteEntityRef	派生クラスでオーバーライドされると、&name; などのエンティティ参照を書き込みます。
	WriteFullEndElement	派生クラスでオーバーライドされると、1 つの要素を閉じ、対応する名前空間スコープをポップします。
	WriteName	派生クラスでオーバーライドされると、指定した名前を書き込み、その名前が W3C 勧告『XML 1.0』(http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) に準拠した有効な名前であるようにします。
	WriteNmToken	派生クラスでオーバーライドされると、指定した名前を書き込み、その名前が W3C 勧告『XML 1.0』(http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) に準拠した有効な NmToken であるようにします。
	WriteNode	オーバーロードされます。 ソース オブジェクトから現在のライタのインスタンスにすべてをコピーします。
	WriteProcessingInstruction	派生クラスでオーバーライドされると、<?name text?> など、名前とテキストの間に空白が入った処理命令を書き込みます。
	WriteQualifiedName	派生クラスでオーバーライドされると、名前空間の限定名を書き込みます。このメソッドは、指定した名前空間のスコープ内にあるプリフィックスを検索します。
	WriteRaw	オーバーロードされます。 派生クラスでオーバーライドされると、生のマークアップを手動で書き込みます。
	WriteStartAttribute	オーバーロードされます。 派生クラスでオーバーライドされると、属性の開始を書き込みます。
	WriteStartDocument	オーバーロードされます。 派生クラスでオーバーライドされると、XML 宣言を書き込みます。
	WriteStartElement	オーバーロードされます。 派生クラスでオーバーライドされると、指定した開始タグを書き込みます。
	WriteString	派生クラスでオーバーライドされると、指定したテキスト内容を書き込みます。
	WriteSurrogateCharEntity	派生クラスでオーバーライドされると、サロゲート文字ペアのサロゲート文字エンティティを生成し、書き込みます。
	WriteValue	オーバーロードされます。 単一の単純型の値を書き込みます。
	WriteWhitespace	派生クラスでオーバーライドされると、指定した空白を書き込みます。

プロテクト メソッド

	名前	説明
	Dispose	XmlWriter によって使用されているアンマネージ リソースを解放し、オプションでマネージ リソースも解放します。
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.IDisposable.Dispose	このメンバの説明については、IDisposable.Dispose のトピックを参照してください。

参照

関連項目

XmlWriter クラス
System.Xml 名前空間

その他の技術情報

XML ドキュメントと XML データ
セキュリティと System.Xml アプリケーション

XmlWriter メンバ

XML データが格納されたストリームまたはファイルを、高速かつ非キャッシュで前方向に生成する方法を提供するライタを表します。

XmlWriter データ型で公開されるメンバを以下の表に示します。

プロテクト コンストラクタ

	名前	説明
	XmlWriter	XmlWriter クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	XmlSpace	派生クラスでオーバーライドされると、現在の xml:space スコープを表す XmlSpace を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Close	派生クラスでオーバーライドされると、このストリームと基になるストリームを閉じます。
	Create	オーバーロードされます。 新しい XmlWriter インスタンスを作成します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Flush	派生クラスでオーバーライドされると、バッファ内のデータをすべて基になるストリームにフラッシュし、基になるストリームもフラッシュします。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	LookupPrefix	派生クラスでオーバーライドされると、名前空間 URI の現在の名前空間スコープで定義された最も近いプリフィックスを返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	WriteAttributes	派生クラスによってオーバーライドされると、XmlReader の現在の位置で見つかったすべての属性を書き込みます。
	WriteAttributeString	オーバーロードされます。 派生クラスでオーバーライドされると、指定した値の属性を書き込みます。
	WriteBase64	派生クラスでオーバーライドされると、指定したバイナリ バイトを Base64 としてエンコードし、その結果生成されるテキストを書き込みます。
	WriteBinHex	派生クラスでオーバーライドされると、指定されたバイナリ バイトを BinHex としてエンコードし、その結果生成されるテキストを書き込みます。
	WriteCData	派生クラスでオーバーライドされると、指定したテキストを含む <![CDATA[...]]> ブロックを書き込みます。
	WriteCharEntity	派生クラスでオーバーライドされると、指定した Unicode 文字値の文字エンティティを強制的に生成します。
	WriteChars	派生クラスでオーバーライドされると、一度に 1 つのバッファにテキストを書き込みます。
	WriteComment	派生クラスでオーバーライドされると、指定したテキストを格納している <!--...--> コメントを書き込みます。
	WriteDocType	派生クラスでオーバーライドされると、指定した名前とオプションの属性を含む DOCTYPE 宣言を書き込みます。
	WriteElementString	オーバーロードされます。 派生クラスでオーバーライドされると、文字列値を含む要素を書き込みます。
	WriteEndAttribute	派生クラスでオーバーライドされると、前の WriteStartAttribute 呼び出しを閉じます。
	WriteEndDocument	派生クラスでオーバーライドされると、開いている任意の要素または属性を閉じ、ライタを Start 状態に戻します。
	WriteEndElement	派生クラスでオーバーライドされると、1 つの要素を閉じ、対応する名前空間スコープをポップします。
	WriteEntityRef	派生クラスでオーバーライドされると、&name; などのエンティティ参照を書き込みます。
	WriteFullEndElement	派生クラスでオーバーライドされると、1 つの要素を閉じ、対応する名前空間スコープをポップします。
	WriteName	派生クラスでオーバーライドされると、指定した名前を書き込み、その名前が W3C 勧告『XML 1.0』(http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) に準拠した有効な名前であるようにします。
	WriteNmToken	派生クラスでオーバーライドされると、指定した名前を書き込み、その名前が W3C 勧告『XML 1.0』(http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) に準拠した有効な NmToken であるようにします。
	WriteNode	オーバーロードされます。 ソース オブジェクトから現在のライタのインスタンスにすべてをコピーします。
	WriteProcessingInstruction	派生クラスでオーバーライドされると、<?name text?> など、名前とテキストの間に空白が入った処理命令を書き込みます。
	WriteQualifiedName	派生クラスでオーバーライドされると、名前空間の限定名を書き込みます。このメソッドは、指定した名前空間のスコープ内にあるプリフィックスを検索します。
	WriteRaw	オーバーロードされます。 派生クラスでオーバーライドされると、生のマークアップを手動で書き込みます。
	WriteStartAttribute	オーバーロードされます。 派生クラスでオーバーライドされると、属性の開始を書き込みます。
	WriteStartDocument	オーバーロードされます。 派生クラスでオーバーライドされると、XML 宣言を書き込みます。
	WriteStartElement	オーバーロードされます。 派生クラスでオーバーライドされると、指定した開始タグを書き込みます。
	WriteString	派生クラスでオーバーライドされると、指定したテキスト内容を書き込みます。
	WriteSurrogateCharEntity	派生クラスでオーバーライドされると、サロゲート文字ペアのサロゲート文字エンティティを生成し、書き込みます。
	WriteValue	オーバーロードされます。 単一の単純型の値を書き込みます。
	WriteWhitespace	派生クラスでオーバーライドされると、指定した空白を書き込みます。

プロテクト メソッド

	名前	説明
	Dispose	XmlWriter によって使用されているアンマネージ リソースを解放し、オプションでマネージ リソースも解放します。
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.IDisposable.Dispose	このメンバの説明については、IDisposable.Dispose のトピックを参照してください。

参照

関連項目

XmlWriter クラス
System.Xml 名前空間

その他の技術情報

XML ドキュメントと XML データ
セキュリティと System.Xml アプリケーション