XmlWriter.WriteCharsAsync(Char[], Int32, Int32) XmlWriter.WriteCharsAsync(Char[], Int32, Int32) XmlWriter.WriteCharsAsync(Char[], Int32, Int32) XmlWriter.WriteCharsAsync(Char[], Int32, Int32) Method

定義

一度に 1 つのバッファーにテキストを非同期に書き込みます。Asynchronously writes text one buffer at a time.

public:
 virtual System::Threading::Tasks::Task ^ WriteCharsAsync(cli::array <char> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task WriteCharsAsync (char[] buffer, int index, int count);
abstract member WriteCharsAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteCharsAsync : char[] * int * int -> System.Threading.Tasks.Task
Public Overridable Function WriteCharsAsync (buffer As Char(), index As Integer, count As Integer) As Task

パラメーター

buffer
Char[]

書き込むテキストを格納している文字配列。Character array containing the text to write.

index
Int32 Int32 Int32 Int32

書き込むテキストの開始を示すバッファー内の位置。The position in the buffer indicating the start of the text to write.

count
Int32 Int32 Int32 Int32

書き込む文字数。The number of characters to write.

戻り値

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

注釈

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

適用対象

こちらもご覧ください