XmlWriter.WriteNameAsync(String) XmlWriter.WriteNameAsync(String) XmlWriter.WriteNameAsync(String) XmlWriter.WriteNameAsync(String) Method

定義

指定した名前が W3C 勧告『XML 1.0』(https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)) に準拠した有効な名前であることを確認し、それを非同期に書き込みます。Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (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 String String String

書き込む名前。The name to write.

戻り値

非同期の WriteName 操作を表すタスク。The task that represents the asynchronous WriteName 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-

Async フラグを true に設定せずに、XmlWriter 非同期メソッドが呼び出されました。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."

注釈

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

適用対象

こちらもご覧ください