共用方式為


XmlWriter.WriteNameAsync(String) 方法

定義

非同步地寫出指定的名稱,以確保它是符合 W3C XML 1.0 建議 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) (英文) 的有效名稱。

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

參數

name
String

要寫入的名稱。

傳回

Task

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

例外狀況

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

-或-

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

備註

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

適用於

另請參閱