BufferedStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

BufferedStream.cs

開始非同步的寫入作業。 (請考慮用 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);

override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult

Public 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 中以零起始的位元組位移，即開始將位元組複製到目前資料流的位置。

count

Int32

寫入的最大位元組數。

callback

AsyncCallback

在非同步寫入作業完成時所呼叫的方法。

state

Object

使用者所提供的物件，其可以從其他要求中區分出這個特定非同步寫入的要求。

傳回

IAsyncResult

物件，這個物件會參考可能還在暫止中的非同步寫入。

例外狀況

ArgumentException

buffer 長度減去 offset 小於 count。

ArgumentNullException

buffer 為 null。

ArgumentOutOfRangeException

offset 或 count 為負。

NotSupportedException

資料流不支援寫入。

備註

在 .NET Framework 4 和舊版中，您必須使用 和 之類的BeginWriteEndWrite方法來實作異步檔案作業。 這些方法仍可在 .NET Framework 4.5 中使用以支援舊版程式代碼;不過，新的異步方法，例如 ReadAsync、 WriteAsync和 FlushAsync，可協助您更輕鬆地實作異步檔案作業。

EndWrite每個都必須從BeginWrite呼叫一次IAsyncResult。 EndWrite 將會封鎖直到 I/O 作業完成為止。