IsolatedStorageFileStream.BeginRead メソッド

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

IsolatedStorageFileStream.BeginRead メソッド

非同期の読み取りを開始します。

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

Visual Basic (宣言)

Public Overrides Function
 BeginRead ( _
    buffer As Byte(), _
    offset As Integer, _
    numBytes As Integer, _
    userCallback As AsyncCallback, _
    stateObject As Object _
) As IAsyncResult

Visual Basic (使用法)

Dim instance As IsolatedStorageFileStream
Dim buffer As Byte()
Dim offset As Integer
Dim numBytes As Integer
Dim userCallback As AsyncCallback
Dim stateObject As Object
Dim returnValue As IAsyncResult

returnValue = instance.BeginRead(buffer, offset, numBytes, userCallback, stateObject)

C#

public override IAsyncResult BeginRead (
    byte[] buffer,
    int offset,
    int numBytes,
    AsyncCallback userCallback,
    Object stateObject
)

C++

public:
virtual IAsyncResult^ BeginRead (
    array<unsigned char>^ buffer, 
    int offset, 
    int numBytes, 
    AsyncCallback^ userCallback, 
    Object^ stateObject
) override

J#

public IAsyncResult BeginRead (
    byte[] buffer, 
    int offset, 
    int numBytes, 
    AsyncCallback userCallback, 
    Object stateObject
)

JScript

public override function BeginRead (
    buffer : byte[], 
    offset : int, 
    numBytes : int, 
    userCallback : AsyncCallback, 
    stateObject : Object
) : IAsyncResult

パラメータ

buffer

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

offset

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

numBytes

読み取る最大バイト数。

userCallback

非同期の読み取り操作が完了したときに呼び出すメソッド。このパラメータはオプションです。

stateObject

非同期の読み取りの状態。

戻り値
非同期の読み取りを表す IAsyncResult オブジェクト。まだ保留状態の場合もあります。読み取ったバイト数を確認するには、IAsyncResult をこのストリームの EndRead メソッドに渡す必要があります。この操作は、BeginRead を呼び出した同じコードを使用するか、または BeginRead に渡されたコールバックで行うことができます。

例外

例外の種類	条件
IOException	ファイルの末尾を越える位置で、非同期の読み取りを試行しました。

解説

ストリームの現在位置は、非同期の読み込みまたは書き込みが発行されたときに更新されます。I/O 操作の実行時ではありません。

読み取られたバイト数を検出するには、この IAsyncResult で EndRead を呼び出す必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
IsolatedStorageFileStream クラス
IsolatedStorageFileStream メンバ
System.IO.IsolatedStorage 名前空間