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

public:
 virtual IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);

public virtual IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);

public virtual IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback callback, object state);

public virtual IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback callback, object? state);

abstract member BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginRead (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

戻り値

非同期の読み込みを表す IAsyncResult。まだ保留状態の場合もあります。

例外

注釈

.NET Framework 4 およびそれ以前のバージョンで非同期 I/O 操作を実装するには、 BeginRead 、 EndRead などのメソッドを使用する必要があります。 これらのメソッドは、レガシ コードをサポートするために .NET Framework 4.5 で引き続き使用できます。ただし、、 WriteAsyncCopyToAsyncFlushAsyncなどのReadAsync新しい非同期メソッドを使用すると、非同期 I/O 操作をより簡単に実装できます。

ストリームでの の既定の BeginRead 実装では、 メソッドが Read 同期的に呼び出されます。つまり Read 、一部のストリームで がブロックされる可能性があります。 ただし、 や などのFileStreamNetworkStreamクラスのインスタンスは、インスタンスが非同期で開かれている場合は、非同期操作を完全にサポートします。 したがって、 の BeginRead 呼び出しは、これらのストリームでブロックされません。 非同期動作を提供するには、(非同期デリゲートなどを使用して) をオーバーライド BeginRead できます。

ストリームの IAsyncResult メソッドに戻り値を EndRead 渡して、読み取られたバイト数を確認し、読み取りに使用されるオペレーティング システム リソースを解放します。 EndRead の呼び出しごとに 1 回呼び出す BeginRead必要があります。 これを行うには、 を呼び出 BeginRead したのと同じコードを使用するか、 に BeginRead渡されたコールバックでを使用します。

ストリーム内の現在位置は、I/O 操作が完了したときではなく、非同期の読み取りまたは書き込みが発行されたときに更新されます。

複数の同時非同期要求によって、要求完了順序が不確実になります。

プロパティを使用して、 CanRead 現在のインスタンスが読み取りをサポートしているかどうかを判断します。

ストリームが閉じているか、無効な引数を渡すと、 から BeginRead例外が直ちにスローされます。 非同期読み取り要求中に発生するエラー (I/O 要求中のディスク障害など) は、スレッド プール スレッドで発生し、 を呼び出 EndReadすときに例外をスローします。

適用対象

こちらもご覧ください

• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み
• 非同期ファイル I/O