XmlWriter.WriteStartDocument

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

XmlWriter.WriteStartDocument メソッド ()

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

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

Visual Basic (宣言)

Public MustOverride Sub
 WriteStartDocument

Visual Basic (使用法)

Dim instance As XmlWriter

instance.WriteStartDocument

C#

public abstract void WriteStartDocument ()

C++

public:
virtual void WriteStartDocument () abstract

J#

public abstract void WriteStartDocument ()

JScript

public abstract function WriteStartDocument
 ()

例外

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

解説

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

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

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

プラットフォーム

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 による XML の書き方

XmlWriter.WriteStartDocument メソッド (Boolean)

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

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

Visual Basic (宣言)

Public MustOverride Sub
 WriteStartDocument ( _
    standalone As Boolean _
)

Visual Basic (使用法)

Dim instance As XmlWriter
Dim standalone As Boolean

instance.WriteStartDocument(standalone)

C#

public abstract void WriteStartDocument (
    bool standalone
)

C++

public:
virtual void WriteStartDocument (
    bool standalone
) abstract

J#

public abstract void WriteStartDocument (
    boolean standalone
)

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 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.WriteStartDocument メソッド

派生クラスでオーバーライドされると、XML 宣言を書き込みます。
オーバーロードの一覧

名前	説明
XmlWriter.WriteStartDocument ()	派生クラスでオーバーライドされると、バージョン "1.0" の XML 宣言を書き込みます。 .NET Compact Framework によってサポートされています。
XmlWriter.WriteStartDocument (Boolean)	派生クラスでオーバーライドされると、バージョン "1.0" の XML 宣言とスタンドアロン属性を書き込みます。 .NET Compact Framework によってサポートされています。

参照

関連項目

XmlWriter クラス
XmlWriter メンバ
System.Xml 名前空間

その他の技術情報

XmlWriter による XML の書き方
XmlWriter による XML の書き方

XmlWriter による XML の書き方