XmlWriter.WriteStartDocument メソッド (Boolean)

派生クラスでオーバーライドされると、バージョン "1.0" の XML 宣言とスタンドアロン属性を書き込みます。

Overloads Public MustOverride Sub WriteStartDocument( _
   ByVal standalone As Boolean _)
[C#]
public abstract void WriteStartDocument(boolstandalone);
[C++]
public: virtual void WriteStartDocument(boolstandalone) = 0;
[JScript]
public abstract 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

参照

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