IsolatedStorageFileStream.BeginWrite メソッド

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

IsolatedStorageFileStream.BeginWrite メソッド

非同期の書き込みを開始します。

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

Visual Basic (宣言)

Public Overrides Function
 BeginWrite ( _
    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.BeginWrite(buffer, offset, numBytes, userCallback, stateObject)

C#

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

C++

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

J#

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

JScript

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

パラメータ

buffer

データを書き込むバッファ。

offset

書き込みの開始位置を示す buffer 内のバイト オフセット。

numBytes

書き込む最大バイト数。

userCallback

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

stateObject

非同期の書き込みの状態。

戻り値
非同期の書き込みを表す IAsyncResult。まだ保留状態の場合もあります。書き込みが完了したことを確認してから、リソースを適切に解放するには、このストリームの EndWrite メソッドに IAsyncResult を渡す必要があります。この操作は、BeginWrite を呼び出した同じコードを使用するか、または BeginWrite に渡されたコールバックで行うことができます。

例外

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

解説

IsolatedStorageFileStream オブジェクトへの書き込みが可能なときにストリームの末尾で書き込みを行うと、ストリームが拡張されます。

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

書き込まれたバイト数を検出するために、このメソッドが返す IAsyncResult オブジェクトを使用して EndWrite を呼び出す必要があります。

プラットフォーム

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 名前空間