XmlWriter.WriteStartDocumentAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
以非同步的方式寫入 XML 宣告。
多載
| WriteStartDocumentAsync() |
以非同步的方式使用「1.0」版寫入 XML 宣告。 |
| WriteStartDocumentAsync(Boolean) |
以非同步的方式使用「1.0」版寫入 XML 宣告與獨立屬性。 |
備註
這是 的非同步版本 WriteStartDocument ，具有相同的功能。 若要使用這個方法，您必須將 Async 旗標設定為 true 。
WriteStartDocumentAsync()
以非同步的方式使用「1.0」版寫入 XML 宣告。
public:
virtual System::Threading::Tasks::Task ^ WriteStartDocumentAsync();public virtual System.Threading.Tasks.Task WriteStartDocumentAsync ();abstract member WriteStartDocumentAsync : unit -> System.Threading.Tasks.Task
override this.WriteStartDocumentAsync : unit -> System.Threading.Tasks.TaskPublic Overridable Function WriteStartDocumentAsync () As Task傳回
表示非同步 WriteStartDocument 作業的工作。
例外狀況
在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。
-或-
在未將 Async 旗標設為 true的情況下呼叫了 XmlWriter 非同步方法。 在此情況下，就會擲回 InvalidOperationException 並顯示訊息「如果您要使用非同步方法，請將 XmlWriterSettings.Async 設為 true」。
備註
這是 的非同步版本 WriteStartDocument ，具有相同的功能。 若要使用這個方法，您必須將 Async 旗標設定為 true 。
另請參閱
適用於
WriteStartDocumentAsync(Boolean)
以非同步的方式使用「1.0」版寫入 XML 宣告與獨立屬性。
public:
virtual System::Threading::Tasks::Task ^ WriteStartDocumentAsync(bool standalone);public virtual System.Threading.Tasks.Task WriteStartDocumentAsync (bool standalone);abstract member WriteStartDocumentAsync : bool -> System.Threading.Tasks.Task
override this.WriteStartDocumentAsync : bool -> System.Threading.Tasks.TaskPublic Overridable Function WriteStartDocumentAsync (standalone As Boolean) As Task參數
- standalone
- Boolean
如果 true，它會寫入「standalone=yes」；如果 false，它會寫入「standalone=no」。
傳回
表示非同步 WriteStartDocument 作業的工作。
例外狀況
在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。
-或-
在未將 Async 旗標設為 true的情況下呼叫了 XmlWriter 非同步方法。 在此情況下，就會擲回 InvalidOperationException 並顯示訊息「如果您要使用非同步方法，請將 XmlWriterSettings.Async 設為 true」。
備註
這是 的非同步版本 WriteStartDocument ，具有相同的功能。 若要使用這個方法，您必須將 Async 旗標設定為 true 。