FileStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) メソッド

定義

非同期の読み込み動作を開始します。Begins an asynchronous read operation. 代わりに ReadAsync(Byte[], Int32, Int32, CancellationToken) を使用することを検討してください。Consider using ReadAsync(Byte[], Int32, Int32, CancellationToken) instead.

public:
 override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ array, int offset, int numBytes, AsyncCallback ^ userCallback, System::Object ^ stateObject);
public override IAsyncResult BeginRead (byte[] array, int offset, int numBytes, AsyncCallback userCallback, object stateObject);
override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overrides Function BeginRead (array As Byte(), offset As Integer, numBytes As Integer, userCallback As AsyncCallback, stateObject As Object) As IAsyncResult

パラメーター

array
Byte[]

データを読み取るバッファー。The buffer to read data into.

offset
Int32

読み取りの開始位置を示す array 内のバイト オフセット。The byte offset in array at which to begin reading.

numBytes
Int32

読み取る最大バイト数。The maximum number of bytes to read.

callback
AsyncCallback

非同期の読み取り操作が完了したときに呼び出されるメソッド。The method to be called when the asynchronous read operation is completed.

state
Object

この特定の非同期読み取り要求を他の要求と区別するために使用するユーザー指定のオブジェクト。A user-provided object that distinguishes this particular asynchronous read request from other requests.

戻り値

非同期の読み取りを参照するオブジェクト。An object that references the asynchronous read.

例外

配列長から offset を差し引いた値が numBytes より小さい値です。The array length minus offset is less than numBytes.

arraynullです。array is null.

offset または numBytes が負の値です。offset or numBytes is negative.

非同期の読み取りがファイルの終わりを超えて試行されました。An asynchronous read was attempted past the end of the file.

適用対象