XmlWriter.WriteNameAsync(String) メソッド

定義

指定した名前が 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

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

戻り値

Task

非同期の 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-

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."

注釈

これは 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.

適用対象

こちらもご覧ください