英語で読む

次の方法で共有


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

定義

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

C#
public override IAsyncResult BeginRead (byte[] array, int offset, int numBytes, AsyncCallback? callback, object? state);
C#
public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);
C#
public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
C#
public override IAsyncResult BeginRead (byte[] array, int offset, int numBytes, AsyncCallback callback, object state);
C#
public override IAsyncResult BeginRead (byte[] array, int offset, int numBytes, AsyncCallback callback, object? state);
C#
public override IAsyncResult BeginRead (byte[] array, int offset, int numBytes, AsyncCallback userCallback, object stateObject);

パラメーター

arraybuffer
Byte[]

データを読み取るバッファー。

offset
Int32

読み取りの開始位置を示す array 内のバイト オフセット。

numBytescount
Int32

読み取る最大バイト数。

callbackuserCallback
AsyncCallback

非同期の読み取り操作が完了したときに呼び出されるメソッド。

statestateObject
Object

この特定の非同期読み取り要求を他の要求と区別するために使用するユーザー指定のオブジェクト。

戻り値

非同期の読み取りを参照するオブジェクト。

例外

配列長から offset を差し引いた値が numBytes より小さい値です。

arraynullです。

offset または numBytes が負の値です。

非同期の読み取りがファイルの終わりを超えて試行されました。

適用対象

製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 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, 4.8.1
.NET Standard 2.0, 2.1