BufferedStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
非同期の書き込み操作を開始します。 (代わりに、WriteAsync(Byte[], Int32, Int32, CancellationToken) の使用を検討してください。)
public:
override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object state);public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object? state);override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResultPublic Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResultパラメーター
- buffer
- Byte[]
現在のストリームに書き込むデータを格納しているバッファー。
- offset
- Int32
現在のストリームへのバイトのコピーを開始する位置を示す buffer 内のバイト オフセット。インデックス番号は 0 から始まります。
- count
- Int32
書き込む最大バイト数。
- callback
- AsyncCallback
非同期の書き込み操作が完了したときに呼び出されるメソッド。
- state
- Object
この特定の非同期書き込み要求を他の要求と区別するために使用するユーザー指定のオブジェクト。
戻り値
まだ保留中である可能性がある非同期書き込みを参照するオブジェクト。
例外
buffer の長さから offset を引いた長さが count 未満です。
buffer が nullです。
offset または count が負の値です。
ストリームは書き込みをサポートしません。
注釈
.NET Framework 4 以前のバージョンでは、 や などのBeginWriteEndWriteメソッドを使用して非同期ファイル操作を実装する必要があります。 これらのメソッドは、従来のコードをサポートするために .NET Framework 4.5 で引き続き使用できますが、 などのReadAsyncWriteAsyncFlushAsync新しい非同期メソッドを使用すると、非同期ファイル操作をより簡単に実装できます。
EndWriteは、 からBeginWriteごとに IAsyncResult 1 回だけ呼び出す必要があります。 EndWrite は、I/O 操作が完了するまでブロックします。
適用対象
.NET