非同期の書き込みを開始します。
Overrides Public Function BeginWrite( _
ByVal buffer() As Byte, _ ByVal offset As Integer, _ ByVal numBytes As Integer, _ ByVal userCallback As AsyncCallback, _ ByVal stateObject As Object _) As IAsyncResult
[C#]
public override IAsyncResult BeginWrite(byte[] buffer,intoffset,intnumBytes,AsyncCallbackuserCallback,objectstateObject);
[C++]
public: IAsyncResult* BeginWrite(unsigned charbuffer __gc[],intoffset,intnumBytes,AsyncCallback* userCallback,Object* stateObject);
[JScript]
public override function BeginWrite(
buffer : Byte[],offset : int,numBytes : int,userCallback : AsyncCallback,stateObject : Object) : IAsyncResult;
パラメータ
- buffer
データを書き込むバッファ。 - offset
書き込みの開始位置を示す array 内のバイト オフセット。 - numBytes
書き込む最大バイト数。 - userCallback
非同期の書き込み操作が完了したときに呼び出されるメソッド。このパラメータはオプションです。 - stateObject
非同期の書き込みの状態。
戻り値
非同期の書き込みを表す IAsyncResult 。まだ保留状態の場合もあります。書き込みが完了したことを確認してから、リソースを適切に解放するには、このストリームの EndWrite メソッドに IAsyncResult を渡す必要があります。この操作は、 BeginWrite を呼び出した同じコードを使用するか、または BeginWrite に渡されたコールバックで行うことができます。
例外
例外の種類 | 条件 |
---|---|
IOException | ファイルの末尾を越える位置で、非同期の書き込みを試行しました。 |
解説
IsolatedStorageFileStream への書き込みが可能なときにストリームの末尾で書き込みを行うと、ストリームが拡張されます。
ストリームの現在位置は、非同期の読み込みまたは書き込みが発行されたときに更新されます。I/O 操作の実行時ではありません。
書き込まれたバイト数を検出するために、このメソッドが返す IAsyncResult を使用して EndWrite を呼び出す必要があります。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
IsolatedStorageFileStream クラス | IsolatedStorageFileStream メンバ | System.IO.IsolatedStorage 名前空間