XmlWriter.WriteEntityRefAsync(String) メソッド

定義

エンティティ参照を &name; として非同期的に書き込みます。Asynchronously writes out an entity reference as &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

パラメーター

name
String

エンティティ参照の名前。The name of the entity reference.

戻り値

Task

非同期の WriteEntityRef 操作を表すタスク。The task that represents the asynchronous WriteEntityRef operation.

例外

先行の非同期操作が完了する前に、 XmlWriter メソッドが呼び出されました。An XmlWriter method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

または-or-

XmlWriter フラグを Async に設定せずに、 true非同期メソッドが呼び出されました。An XmlWriter asynchronous method was called without setting the Async flag to true. この場合、非同期メソッドを使用するには XmlWriterSettings.Async を true に設定する必要があることを示すメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods."

注釈

これは WriteEntityRefの非同期バージョンであり、同じ機能を備えています。This is the asynchronous version of WriteEntityRef, with the same functionality. このメソッドを使用するには、Async フラグを trueに設定する必要があります。To use this method, you must set the Async flag to true.

適用対象

こちらもご覧ください