XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Method

定義

XML ドキュメントに埋め込まれたテキストの大量のストリームを非同期に読み取ります。Asynchronously reads large streams of text embedded in an XML document.

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

パラメーター

buffer
Char[]

テキストの内容が書き込まれるバッファーとして機能する文字の配列。The array of characters that serves as the buffer to which the text contents are written. この値を null にすることはできません。This value cannot be null.

index
Int32 Int32 Int32 Int32

XmlReader が結果のコピーを開始できる、バッファー内のオフセット。The offset within the buffer where the XmlReader can start to copy the results.

count
Int32 Int32 Int32 Int32

バッファーにコピーする最大文字数。The maximum number of characters to copy into the buffer. コピーされた実際の文字数は、このメソッドから返されます。The actual number of characters copied is returned from this method.

戻り値

バッファー内へ読み取られた文字数。The number of characters read into the buffer. それ以上テキストの内容がない場合は、値として 0 が返されます。The value zero is returned when there is no more text content.

例外

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader 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 に設定せずに、XmlReader 非同期メソッドが呼び出されました。An XmlReader asynchronous method was called without setting the Async flag to true. この場合、「非同期メソッドを使用する場合、XmlReaderSettings.Async を True に設定します」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods."

注釈

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

適用対象

こちらもご覧ください