XmlWriter.WriteStartDocument メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスでオーバーライドされると、XML 宣言を書き込みます。
オーバーロード
| 名前 | 説明 |
|---|---|
| WriteStartDocument(Boolean) |
派生クラスでオーバーライドされた場合は、バージョン "1.0" とスタンドアロン属性を使用して XML 宣言を書き込みます。 |
| WriteStartDocument() |
派生クラスでオーバーライドされた場合は、バージョン "1.0" で XML 宣言を書き込みます。 |
注釈
このメソッドの非同期バージョンについては、 WriteStartDocumentAsyncを参照してください。
WriteStartDocument(Boolean)
- ソース:
- XmlWriter.cs
- ソース:
- XmlWriter.cs
- ソース:
- XmlWriter.cs
- ソース:
- XmlWriter.cs
- ソース:
- XmlWriter.cs
派生クラスでオーバーライドされた場合は、バージョン "1.0" とスタンドアロン属性を使用して XML 宣言を書き込みます。
public:
abstract void WriteStartDocument(bool standalone);public abstract void WriteStartDocument(bool standalone);abstract member WriteStartDocument : bool -> unitPublic MustOverride Sub WriteStartDocument (standalone As Boolean)パラメーター
- standalone
- Boolean
true場合、"standalone=yes" と書き込まれます。false場合、"standalone=no" と書き込まれます。
例外
これは、コンストラクターの後に呼び出される最初の書き込みメソッドではありません。
-又は-
前の非同期操作が完了する前に、 XmlWriter メソッドが呼び出されました。 この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。
注釈
ドキュメントのエンコード レベルは、ライターの実装方法によって決まります。 たとえば、Encoding コンストラクターでXmlTextWriter オブジェクトが指定されている場合、エンコード属性の値が決定されます。
WriteStartDocumentが呼び出されると、ライターは、記述しているものが整形式の XML ドキュメントであることを検証します。 たとえば、XML 宣言が最初のノードであるか、ルート レベルの要素が 1 つしか存在しないことを確認します。 このメソッドが呼び出されない場合、ライターは XML フラグメントが書き込まれていると想定し、ルート レベルの規則を適用しません。
WriteStartDocumentが呼び出され、WriteProcessingInstruction メソッドを使用して別の XML 宣言を作成すると、例外がスローされます。
このメソッドの非同期バージョンについては、 WriteStartDocumentAsyncを参照してください。
適用対象
WriteStartDocument()
- ソース:
- XmlWriter.cs
- ソース:
- XmlWriter.cs
- ソース:
- XmlWriter.cs
- ソース:
- XmlWriter.cs
- ソース:
- XmlWriter.cs
派生クラスでオーバーライドされた場合は、バージョン "1.0" で XML 宣言を書き込みます。
public:
abstract void WriteStartDocument();public abstract void WriteStartDocument();abstract member WriteStartDocument : unit -> unitPublic MustOverride Sub WriteStartDocument ()例外
これは、コンストラクターの後に呼び出される最初の書き込みメソッドではありません。
-又は-
前の非同期操作が完了する前に、 XmlWriter メソッドが呼び出されました。 この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。
注釈
ドキュメントのエンコード レベルは、ライターの実装方法によって決まります。 たとえば、Encoding コンストラクターでXmlTextWriter オブジェクトが指定されている場合、エンコード属性の値が決定されます。 このメソッドでは、スタンドアロン属性は作成されません。
WriteStartDocument呼び出されると、ライターは、記述しているものが整形式の XML ドキュメントであることを検証します。 たとえば、XML 宣言が最初のノードであるか、ルート レベルの要素が 1 つしか存在しないことを確認します。 このメソッドが呼び出されない場合、ライターは XML フラグメントが書き込まれていると想定し、ルート レベルの規則を適用しません。
WriteStartDocumentが呼び出され、WriteProcessingInstruction メソッドを使用して別の XML 宣言を作成すると、例外がスローされます。
このメソッドの非同期バージョンについては、 WriteStartDocumentAsyncを参照してください。
