XmlWriter.WriteEntityRefAsync(String) 方法

定義

重要

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

以非同步的方式將實體參考寫出為 &name;。

public:
 virtual System::Threading::Tasks::Task ^ WriteEntityRefAsync(System::String ^ name);

public virtual System.Threading.Tasks.Task WriteEntityRefAsync (string name);

abstract member WriteEntityRefAsync : string -> System.Threading.Tasks.Task
override this.WriteEntityRefAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteEntityRefAsync (name As String) As Task

實體參考的名稱。

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

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

-或-

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

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