英語で読む

次の方法で共有


XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) メソッド

定義

XML ドキュメントに埋め込まれたテキストの大量のストリームを非同期に読み取ります。

C#
public virtual System.Threading.Tasks.Task<int> ReadValueChunkAsync (char[] buffer, int index, int count);

パラメーター

buffer
Char[]

テキストの内容が書き込まれるバッファーとして機能する文字の配列。 この値を null にすることはできません。

index
Int32

XmlReader が結果のコピーを開始できる、バッファー内のオフセット。

count
Int32

バッファーにコピーする最大文字数。 コピーされた実際の文字数は、このメソッドから返されます。

戻り値

Task<Int32>

バッファー内へ読み取られた文字数。 それ以上テキストの内容がない場合は、値として 0 が返されます。

例外

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

  • または -

Async フラグを true に設定せずに、XmlReader 非同期メソッドが呼び出されました。 この場合、「非同期メソッドを使用する場合、XmlReaderSettings.Async を True に設定します」というメッセージと共に InvalidOperationException がスローされます。

注釈

これは、同じ機能を備えた非同期バージョンです ReadValueChunk。 このメソッドを使用するには、フラグtrueAsync .

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

こちらもご覧ください