XmlWriter.WriteStringAsync(String) 方法

定義

以非同步的方式寫入指定的文字內容。

C#
public virtual System.Threading.Tasks.Task WriteStringAsync (string text);
C#
public virtual System.Threading.Tasks.Task WriteStringAsync (string? text);

參數

text
String

要寫入的文字。

傳回

Task

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

例外狀況

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

-或-

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

備註

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

適用於

產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

另請參閱