次の方法で共有


Stream.EndRead メソッド

保留中の非同期読み取りが完了するまで待機します。

Public Overridable Function EndRead( _
   ByVal asyncResult As IAsyncResult _) As Integer
[C#]
public virtual int EndRead(IAsyncResultasyncResult);
[C++]
public: virtual int EndRead(IAsyncResult* asyncResult);
[JScript]
public function EndRead(
   asyncResult : IAsyncResult) : int;

パラメータ

  • asyncResult
    終了させる保留状態の非同期リクエストへの参照。

戻り値

ストリームから読み取ったバイト数 (0 ~要求したバイト数の間の数値)。0 が返されるのは、ストリームの末尾で読み取ろうとしたときだけです。それ以外の場合は、少なくとも 1 バイトが読み込み可能になるまでブロックします。

例外

例外の種類 条件
ArgumentNullException asyncResult が null 参照 (Visual Basic では Nothing) です。
ArgumentException asyncResult は、現在のストリームの BeginRead メソッドで開始されたものではありません。

解説

ファイルの作成およびテキストのファイルへの書き込みの例については、「 ファイルへのテキストの書き込み 」を参照してください。ファイルからのテキストの読み取りの例については、「 ファイルからのテキストの読み取り 」を参照してください。バイナリ ファイルの読み取りおよび書き込みの例については、「 新しく作成したデータ ファイルの読み取りと書き込み 」を参照してください。非同期ファイル I/O の例については、「 非同期ファイル I/O 」を参照してください。

ストリームから読み取ったバイト数を判断するには、 EndRead を呼び出します。

EndRead は、 BeginRead からの各 IAsyncResult ごとに 1 回ずつ呼び出すことができます。

このメソッドは、I/O 操作が完了するまでブロックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

Stream クラス | Stream メンバ | System.IO 名前空間 | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み | 非同期ファイル I/O