共用方式為


XmlWriter.WriteCommentAsync(String) 方法

定義

以非同步的方式寫出包含指定文字的註解 <!--...-->。

public:
 virtual System::Threading::Tasks::Task ^ WriteCommentAsync(System::String ^ text);
public virtual System.Threading.Tasks.Task WriteCommentAsync (string text);
public virtual System.Threading.Tasks.Task WriteCommentAsync (string? text);
abstract member WriteCommentAsync : string -> System.Threading.Tasks.Task
override this.WriteCommentAsync : string -> System.Threading.Tasks.Task
Public Overridable Function WriteCommentAsync (text As String) As Task

參數

text
String

要放入註解中的文字。

傳回

Task

表示非同步 WriteComment 作業的工作。

例外狀況

在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下,會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

-或-

在未將 Async 旗標設為 true的情況下呼叫了 XmlWriter 非同步方法。 在此情況下,就會擲回 InvalidOperationException 並顯示訊息「如果您要使用非同步方法,請將 XmlWriterSettings.Async 設為 true」。

備註

這是 的非同步版本 WriteComment ,具有相同的功能。 若要使用此方法,您必須將 Async 旗標設定為 true

適用於

另請參閱