XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
XML ドキュメントに埋め込まれたテキストの大きなストリームを非同期的に読み取ります。
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[]
テキストの内容が書き込まれるバッファーとして機能する文字の配列。 この値を null にすることはできません。
- count
- Int32
バッファーにコピーする最大文字数。 コピーされた実際の文字数は、このメソッドから返されます。
戻り値
バッファーに読み込まれる文字数。 値 0 は、それ以上テキスト コンテンツがない場合に返されます。
例外
前の非同期操作が完了する前に、 XmlReader メソッドが呼び出されました。 この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。
Async フラグをtrueに設定せずに、XmlReader非同期メソッドが呼び出されました。 この場合、"非同期メソッドを使用する場合は、XmlReaderSettings.Async を true に設定する" というメッセージで InvalidOperationException がスローされます。
注釈
これは、同じ機能を持つ ReadValueChunkの非同期バージョンです。 このメソッドを使用するには、 Async フラグを true に設定する必要があります。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 ReadValueChunk(Char[], Int32, Int32)によってスローされる例外を参照してください。
