IsolatedStorageFileStream.ReadAsync メソッド

ソース:

IsolatedStorageFileStream.cs

ソース:

IsolatedStorageFileStream.cs

ソース:

IsolatedStorageFileStream.cs

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 に読み取られた合計バイト数をラップします。 要求しただけのバイト数を読み取ることができなかった場合、この値は要求したバイト数より小さくなります。ストリームの末尾に到達した場合は 0 になることがあります。

例外

注釈

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

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

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

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

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

ソース:

IsolatedStorageFileStream.cs

ソース:

IsolatedStorageFileStream.cs

ソース:

IsolatedStorageFileStream.cs

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 に読み取られた合計バイト数をラップします。 要求しただけのバイト数を読み取ることができなかった場合、この値は要求したバイト数より小さくなります。ストリームの末尾に到達した場合は 0 になることがあります。

例外