IsolatedStorageFileStream.ReadAsync メソッド

定義

名前空間:

System.IO.IsolatedStorage

アセンブリ:

System.IO.IsolatedStorage.dll

オーバーロード

ReadAsync(Byte[], Int32, Int32, CancellationToken)	非同期で現在のバッファー内の IsolatedStorageFileStream オブジェクトからバイト配列にバイトをコピーします。
ReadAsync(Memory<Byte>, CancellationToken)	非同期で現在のバッファー内の IsolatedStorageFileStream オブジェクトからバイト メモリ範囲にバイトをコピーします。

ReadAsync(Byte[], Int32, Int32, CancellationToken)

ソース:

IsolatedStorageFileStream.cs

非同期で現在のバッファー内の IsolatedStorageFileStream オブジェクトからバイト配列にバイトをコピーします。

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

パラメーター

buffer

Byte[]

データを書き込むバッファー。

offset

Int32

書き込みの開始位置を示すバッファー内のオフセット。

count

Int32

読み取る最大バイト数。

cancellationToken

CancellationToken

キャンセル要求を監視するためのトークン。 既定値は None です。

戻り値

Task<Int32>

非同期の読み取り操作を表すタスク。 buffer に読み取られた合計バイト数をラップします。 要求しただけのバイト数を読み取ることができなかった場合、この値は要求したバイト数より小さくなります。ストリームの末尾に到達した場合は 0 になることがあります。

例外

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

パラメーターにはbuffer、 クラスのBufferインスタンス、または、、Int64SByteCharUInt32SingleInt16Int32UInt16UInt64、または Doubleのいずれかの型Byteの配列を指定できます。

読み取り操作が成功した場合、ストリームの現在位置は読み取られたバイト数だけ進みます。 例外が発生した場合、ストリームの現在位置は変更されません。

メソッドは ReadAsync 、実際の型に buffer 関係なく、 パラメーターをバイト ブロックとして扱います。 同様に offset 、 パラメーターと count パラメーターは常にバイト単位で指定されます。 バイト配列以外のパラメーターの場合buffer、これは、 または の正しい値offsetcountを形成するには、要素インデックスまたは要素数にバイト単位の要素サイズを乗算する必要があることを意味します。

メソッドは ReadAsync 、ストリームの末尾に達した場合にのみ 0 を返します。 それ以外の場合は、 ReadAsync 返す前に常にストリームから少なくとも 1 バイトを読み取ります。 へのReadAsync呼び出し時に IsolatedStorageFileStream オブジェクトから使用できるデータがない場合、 メソッドは、少なくとも 1 バイトのデータが返されるまでブロックします。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Read(Byte[], Int32, Int32)スローされる例外に関するページを参照してください。

ReadAsync(Memory<Byte>, CancellationToken)

ソース:

IsolatedStorageFileStream.cs

非同期で現在のバッファー内の IsolatedStorageFileStream オブジェクトからバイト メモリ範囲にバイトをコピーします。

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

パラメーター

buffer

Memory<Byte>

データを書き込むバッファー。

cancellationToken

CancellationToken

キャンセル要求を監視するためのトークン。 既定値は None です。

戻り値

ValueTask<Int32>

非同期の読み取り操作を表すタスク。 buffer に読み取られた合計バイト数をラップします。 要求しただけのバイト数を読み取ることができなかった場合、この値は要求したバイト数より小さくなります。ストリームの末尾に到達した場合は 0 になることがあります。

例外

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。