XmlWriter.WriteNameAsync(String) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

非同步地寫出指定的名稱，以確保它是符合 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

要寫入的名稱。

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

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

-或-

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

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