Stream.EndRead メソッド

.NET Framework クラス ライブラリ リファレンス

Stream.EndRead メソッド

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

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 EndRead ( _
    asyncResult As IAsyncResult _
) As Integer

Visual Basic (使用法)

Dim instance As Stream
Dim asyncResult As IAsyncResult
Dim returnValue As Integer

returnValue = instance.EndRead(asyncResult)

C#

public virtual int EndRead (
    IAsyncResult asyncResult
)

C++

public:
virtual int EndRead (
    IAsyncResult^ asyncResult
)

J#

public 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 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Stream クラス
Stream メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む
非同期ファイル I/O