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