XmlTextWriter.WriteStartDocument メソッド (Boolean)

バージョン "1.0" とスタントアロン属性を使用して XML 宣言を書き込みます。

Overrides Overloads Public Sub WriteStartDocument( _
   ByVal standalone As Boolean _)
[C#]
public override void WriteStartDocument(boolstandalone);
[C++]
public: void WriteStartDocument(boolstandalone);
[JScript]
public override function WriteStartDocument(
   standalone : Boolean);

パラメータ

  • standalone
    true の場合は "standalone=yes"、 false の場合は "standalone=no" を書き込みます。

例外

例外の種類 条件
InvalidOperationException これは、コンストラクタの後に呼び出された最初の書き込みメソッドではありません。

解説

ドキュメントのエンコーディング レベルは、ライタが実装される方法によって決まります。たとえば、 Encoding オブジェクトが XmlTextWriter コンストラクタで指定される場合は、これによってエンコーディング属性の値が決まります。

WriteStartDocument が呼び出されると、ライタは、作成しているドキュメントが整形式の XML ドキュメントであることを検証します。たとえば、XML 宣言が最初のノードであること、ルート レベルの要素が 1 つだけ存在することなどを確認します。このメソッドが呼び出されない場合、ライタは XML フラグメントが書き込み中であると見なし、ルート レベルの規則は適用しません。

WriteStartDocument が呼び出されてから WriteProcessingInstruction メソッドを使用して別の XML 宣言を作成する場合は、例外がスローされます。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

XmlTextWriter クラス | XmlTextWriter メンバ | System.Xml 名前空間 | XmlTextWriter.WriteStartDocument オーバーロードの一覧