IsolatedStorageFileStream.BeginWrite メソッド

定義

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

public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ array, int offset, int numBytes, AsyncCallback ^ userCallback, System::Object ^ stateObject);
public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int numBytes, AsyncCallback ^ userCallback, System::Object ^ stateObject);
public override IAsyncResult BeginWrite(byte[] array, int offset, int numBytes, AsyncCallback? userCallback, object? stateObject);
public override IAsyncResult BeginWrite(byte[] buffer, int offset, int numBytes, AsyncCallback userCallback, object stateObject);
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overrides Function BeginWrite (array As Byte(), offset As Integer, numBytes As Integer, userCallback As AsyncCallback, stateObject As Object) As IAsyncResult
Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, numBytes As Integer, userCallback As AsyncCallback, stateObject As Object) As IAsyncResult

パラメーター

bufferarray
Byte[]

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

offset
Int32

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

numBytes
Int32

書き込む最大バイト数。

userCallback
AsyncCallback

非同期書き込み操作が完了したときに呼び出すメソッド。 このパラメーターは省略可能です。

stateObject
Object

非同期書き込みの状態。

返品

非同期書き込みを表す IAsyncResult 。これは、まだ保留中である可能性があります。 この IAsyncResult は、書き込みが完了したことを確認し、リソースを適切に解放するために、このストリームの EndWrite(IAsyncResult) メソッドに渡す必要があります。 これを行うには、 BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) を呼び出したコードと同じコードを使用するか、 BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)に渡されたコールバックで実行します。

例外

非同期書き込みがファイルの末尾を超えて試行されました。

注釈

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

ストリーム内の現在の位置は、I/O 操作が完了したときではなく、非同期の読み取りまたは書き込みを発行すると更新されます。

書き込まれたバイト数を調べるには、このメソッドが返すEndWrite オブジェクトでIAsyncResultを呼び出す必要があります。

適用対象