XmlTextWriterとは? わかりやすく解説

XmlTextWriter クラス

W3C 勧告Extensible Markup Language (XML) 1.0』および勧告Namespaces in XML』に準拠する XML データ格納するストリームまたはファイル高速に、非キャッシュで、前方向に生成する方法提供するライタ表します

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

Public Class XmlTextWriter
    Inherits XmlWriter
Dim instance As XmlTextWriter
public class XmlTextWriter : XmlWriter
public class XmlTextWriter extends XmlWriter
public class XmlTextWriter extends
 XmlWriter
解説解説

このクラスは、XmlWriter クラス実装ます。

XmlTextWriter は、現在の要素スタック定義されすべての名前空間対応する名前空間スタック保持しますXmlTextWriter使用すると、手動名前空間宣言できます

 w.WriteStartElement("root");
 w.WriteAttributeString("xmlns", "x", null, "urn:1");
  w.WriteStartElement("item","urn:1");
  w.WriteEndElement();
  w.WriteStartElement("item","urn:1");
  w.WriteEndElement();
 w.WriteEndElement();

上記C# コードで、次の出力生成されます。XmlTextWriter は、名前空間宣言ルート要素昇格させ、2 つの子要素重複しないようにします。子要素は、名前空間宣言からプリフィックスピック アップします

 <root xmlns:x="urn:1">
  <x:item/>
  <x:item/>
 </x:root>

XmlTextWriter使用すると、現在の名前空間宣言オーバーライドできます名前空間 URI "123" が "abc" でオーバーライドされ、XML 要素 <x:node xmlns:x="abc"/>作成する例を次に示します

 w.WriteStartElement("x","node","123");
 w.WriteAttributeString("xmlns","x",null,"abc");

プリフィックス引数として取得する書き込みメソッド使用して使用するプリフィックス指定することもできます2 つ異なプリフィックスを同じ名前空間 URI割り当てXML テキスト <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>作成する例を次に示します

 XmlTextWriter w = new XmlTextWriter(Console.Out);
 w.WriteStartElement("x","root","urn:1");
  w.WriteStartElement("y","item","urn:1");
  w.WriteEndElement();
 w.WriteEndElement();
 w.Close();

異なプリフィックスを同じ名前空間 URI割り当てる複数名前空間宣言がある場合XmlTextWriter は、名前空間宣言スタックを逆方向検索し最も近いものを選択します

 XmlTextWriter w = new XmlTextWriter(Console.Out);
 w.Formatting = Formatting.Indented;
 w.WriteStartElement("x","root","urn:1");
 w.WriteStartElement("y","item","urn:1");
 w.WriteAttributeString("attr","urn:1","123");
 w.WriteEndElement();
 w.WriteEndElement();
 w.Close();

上記C# の例では、WriteAttributeString 呼び出しプリフィックス指定しないため、ライタは、名前空間スタック最後にプッシュされたプリフィックス使用し次の XML作成します

 <x:root xmlns:x="urn:1">
  <y:item y:attr="123" xmlns:y="urn:1" />
 </x:root>

名前空間競合発生すると、XmlTextWriter は、代替プリフィックス生成して競合解決します。たとえば、属性要素プリフィックスが同じで、名前空間異な場合XmlWriter は、属性対し代替プリフィックス生成します生成されプリフィックスには、n{i} という名前が付けられます。i は 1 から始まる数字です。この数字は、要素ごとに 1 にリセットされます。

名前空間 URI関連付けられる属性は、プリフィックスを持つ必要があります (既定名前空間属性適用されません)。これは、W3C 勧告Namespaces in XML』のセクション 5.2準拠します。属性名前空間 URI参照していても、プリフィックス指定してない場合は、ライタ属性プリフィックス生成します

空の要素書き込むと、タグ名と終了タグの間に <item /> などの空白追加されます。これにより、以前のバージョンブラウザとの互換性を保つことができます

Stringメソッド パラメータとして使用すると、null 参照 (Visual Basic では Nothing) と String.Empty等しくなりますString.Empty は、W3C規則準拠します。

厳密に指定されデータ書き込むには、XmlConvert クラス使用してデータ型文字列変換します。たとえば、次に示す C# コードは、データDouble から String変換し要素 <price>19.95</price>書き込みます

 Double price = 19.95;
 writer.WriteElementString("price", XmlConvert.ToString(price));

XmlTextWriter次のことをチェックしません。

XML書き込みに関する詳細については、「XmlWriter による XML書き方」を参照してください

セキュリティについての考慮事項
継承階層継承階層
System.Object
   System.Xml.XmlWriter
    System.Xml.XmlTextWriter
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextWriter コンストラクタ (String, Encoding)

指定したファイル使用して、XmlTextWriter クラスインスタンス作成します

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

例外例外
例外種類条件

ArgumentException

エンコーディングサポートされていません。ファイル名が空で、空白しか含んでいないか、無効な文字1 つ以上含んでます。

UnauthorizedAccessException

アクセス拒否されました。

ArgumentNullException

ファイル名null 参照 (Visual Basic では Nothing) です。

DirectoryNotFoundException

書き込むディレクトリが見つかりません。

IOException

ファイル名には、ファイル名ディレクトリ名、またはボリューム ラベル不正な構文または無効な構文含まれています。

SecurityException

呼び出し元に必要なアクセス許可がありません。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextWriter コンストラクタ (TextWriter)

指定した TextWriter使用して XmlTextWriter クラスインスタンス作成します

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

public XmlTextWriter (
    TextWriter w
)
public:
XmlTextWriter (
    TextWriter^ w
)
public XmlTextWriter (
    TextWriter w
)
public function XmlTextWriter (
    w : TextWriter
)

パラメータ

w

書き込む TextWriterTextWriter が既に正しエンコーディング設定されていることを前提にしています。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextWriter コンストラクタ (Stream, Encoding)

指定したストリームおよびエンコーディング使用してXmlTextWriter クラスインスタンス作成します

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

例外例外
例外種類条件

ArgumentException

エンコーディングサポートされていないか、ストリーム書き込むことができません。

ArgumentNullException

wnull 参照 (Visual Basic では Nothing) です。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextWriter コンストラクタ


XmlTextWriter プロパティ


XmlTextWriter メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド参照)
  名前 説明
パブリック メソッド Close オーバーライドされます。 このストリームおよび基になるストリーム閉じます
パブリック メソッド Create  オーバーロードされます新しXmlWriter インスタンス作成します。 ( XmlWriter から継承されます。)
パブリック メソッド Equals  オーバーロードされます2 つObject インスタンス等しかどうか判断します。 ( Object から継承されます。)
パブリック メソッド Flush オーバーライドされますバッファ内のデータをすべて基になるストリームフラッシュし、基になるストリームフラッシュます。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用適してます。 ( Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスType取得します。 ( Object から継承されます。)
パブリック メソッド LookupPrefix オーバーライドされます名前空間 URI現在の名前空間スコープ定義されたものに最も近いプリフィックス返します
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 ( Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String返します。 ( Object から継承されます。)
パブリック メソッド WriteAttributes  派生クラスによってオーバーライドされると、XmlReader現在の位置見つかったすべての属性書き込みます。 ( XmlWriter から継承されます。)
パブリック メソッド WriteAttributeString  オーバーロードされます派生クラスオーバーライドされると、指定した値の属性書き込みます。 ( XmlWriter から継承されます。)
パブリック メソッド WriteBase64 オーバーライドされます指定したバイナリ バイトbase64 としてエンコードし、その結果生成されるテキスト書き込みます
パブリック メソッド WriteBinHex オーバーライドされます指定したバイナリ バイトbinhex としてエンコードし、その結果生成されるテキスト書き込みます
パブリック メソッド WriteCData オーバーライドされます指定したテキスト格納する <![CDATA[...]]> ブロック書き込みます
パブリック メソッド WriteCharEntity オーバーライドされます指定した Unicode 文字値の文字エンティティ強制的に生成します
パブリック メソッド WriteChars オーバーライドされます一度1 つバッファテキスト書き込みます
パブリック メソッド WriteComment オーバーライドされます指定したテキスト格納するコメント <!--...--> を書き込みます
パブリック メソッド WriteDocType オーバーライドされます。 名前とオプション属性指定してDOCTYPE 宣言書き込みます
パブリック メソッド WriteElementString  オーバーロードされます派生クラスオーバーライドされると、文字列値を含む要素書き込みます。 ( XmlWriter から継承されます。)
パブリック メソッド 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  オーバーロードされますソース オブジェクトから現在のライタインスタンスにすべてをコピーします。 ( XmlWriter から継承されます。)
パブリック メソッド WriteProcessingInstruction オーバーライドされます。 <?name text?> のように、nametext の間に空白入れた処理命令書き込みます
パブリック メソッド WriteQualifiedName オーバーライドされます名前空間限定名を書き込みます。このメソッドは、指定した名前空間スコープ内にあるプリフィックス検索します
パブリック メソッド WriteRaw オーバーロードされますオーバーライドされます手動で生のマークアップ書き込みます
パブリック メソッド WriteStartAttribute オーバーロードされます属性開始書き込みます
パブリック メソッド WriteStartDocument オーバーロードされますオーバーライドされますバージョン "1.0" で XML 宣言書き込みます
パブリック メソッド WriteStartElement オーバーロードされます指定した開始タグ書き込みます
パブリック メソッド WriteString オーバーライドされます指定したテキストの内容書き込みます
パブリック メソッド WriteSurrogateCharEntity オーバーライドされますサロゲート文字ペアサロゲート文字エンティティ生成し書き込みます
パブリック メソッド WriteValue  オーバーロードされます単一の単純型の値を書き込みます。 ( XmlWriter から継承されます。)
パブリック メソッド WriteWhitespace オーバーライドされます指定した空白書き込みます
プロテクト メソッドプロテクト メソッド
参照参照

XmlTextWriter メンバ

W3C 勧告Extensible Markup Language (XML) 1.0』および勧告Namespaces in XML』に準拠する XML データ格納するストリームまたはファイル高速に、非キャッシュで、前方向に生成する方法提供するライタ表します

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


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド XmlTextWriter オーバーロードされますXmlTextWriter クラスインスタンス作成します
パブリック プロパティパブリック プロパティ
パブリック メソッドパブリック メソッド
( プロテクト メソッド参照)
  名前 説明
パブリック メソッド Close オーバーライドされます。 このストリームおよび基になるストリーム閉じます
パブリック メソッド Create  オーバーロードされます新しXmlWriter インスタンス作成します。 (XmlWriter から継承されます。)
パブリック メソッド Equals  オーバーロードされます2 つObject インスタンス等しかどうか判断します。 (Object から継承されます。)
パブリック メソッド Flush オーバーライドされますバッファ内のデータをすべて基になるストリームフラッシュし、基になるストリームフラッシュます。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用適してます。 (Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスType取得します。 (Object から継承されます。)
パブリック メソッド LookupPrefix オーバーライドされます名前空間 URI現在の名前空間スコープ定義されたものに最も近いプリフィックス返します
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 (Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String返します。 (Object から継承されます。)
パブリック メソッド WriteAttributes  派生クラスによってオーバーライドされると、XmlReader現在の位置見つかったすべての属性書き込みます。 (XmlWriter から継承されます。)
パブリック メソッド WriteAttributeString  オーバーロードされます派生クラスオーバーライドされると、指定した値の属性書き込みます。 (XmlWriter から継承されます。)
パブリック メソッド WriteBase64 オーバーライドされます指定したバイナリ バイトbase64 としてエンコードし、その結果生成されるテキスト書き込みます
パブリック メソッド WriteBinHex オーバーライドされます指定したバイナリ バイトbinhex としてエンコードし、その結果生成されるテキスト書き込みます
パブリック メソッド WriteCData オーバーライドされます指定したテキスト格納する <![CDATA[...]]> ブロック書き込みます
パブリック メソッド WriteCharEntity オーバーライドされます指定した Unicode 文字値の文字エンティティ強制的に生成します
パブリック メソッド WriteChars オーバーライドされます一度1 つバッファテキスト書き込みます
パブリック メソッド WriteComment オーバーライドされます指定したテキスト格納するコメント <!--...--> を書き込みます
パブリック メソッド WriteDocType オーバーライドされます。 名前とオプション属性指定してDOCTYPE 宣言書き込みます
パブリック メソッド WriteElementString  オーバーロードされます派生クラスオーバーライドされると、文字列値を含む要素書き込みます。 (XmlWriter から継承されます。)
パブリック メソッド 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  オーバーロードされますソース オブジェクトから現在のライタインスタンスにすべてをコピーします。 (XmlWriter から継承されます。)
パブリック メソッド WriteProcessingInstruction オーバーライドされます。 <?name text?> のように、nametext の間に空白入れた処理命令書き込みます
パブリック メソッド WriteQualifiedName オーバーライドされます名前空間限定名を書き込みます。このメソッドは、指定した名前空間スコープ内にあるプリフィックス検索します
パブリック メソッド WriteRaw オーバーロードされますオーバーライドされます手動で生のマークアップ書き込みます
パブリック メソッド WriteStartAttribute オーバーロードされます属性開始書き込みます
パブリック メソッド WriteStartDocument オーバーロードされますオーバーライドされますバージョン "1.0" で XML 宣言書き込みます
パブリック メソッド WriteStartElement オーバーロードされます指定した開始タグ書き込みます
パブリック メソッド WriteString オーバーライドされます指定したテキストの内容書き込みます
パブリック メソッド WriteSurrogateCharEntity オーバーライドされますサロゲート文字ペアサロゲート文字エンティティ生成し書き込みます
パブリック メソッド WriteValue  オーバーロードされます単一の単純型の値を書き込みます。 (XmlWriter から継承されます。)
パブリック メソッド WriteWhitespace オーバーライドされます指定した空白書き込みます
プロテクト メソッドプロテクト メソッド
参照参照



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「XmlTextWriter」の関連用語

XmlTextWriterのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



XmlTextWriterのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2024 Microsoft.All rights reserved.

©2024 GRAS Group, Inc.RSS