GZipStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Метод

Определение

Начинает операцию асинхронной записи.Begins an asynchronous write operation. (Вместо него рекомендуется использовать метод WriteAsync(Byte[], Int32, Int32).)(Consider using the WriteAsync(Byte[], Int32, Int32) method instead.)

public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ array, int offset, int count, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ cback, System::Object ^ state);
public override IAsyncResult BeginWrite (byte[] array, int offset, int count, AsyncCallback? asyncCallback, object? asyncState);
public override IAsyncResult BeginWrite (byte[] array, int offset, int count, AsyncCallback asyncCallback, object asyncState);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback cback, object state);
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, count As Integer, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, cback As AsyncCallback, state As Object) As IAsyncResult

Параметры

arraybuffer
Byte[]

Буфер, содержащий данные для записи в текущий поток.The buffer containing data to write to the current stream.

offset
Int32

Смещение байтов в array, с которого начинается запись.The byte offset in array at which to begin writing.

count
Int32

Максимальное число байтов для записи.The maximum number of bytes to write.

asyncCallbackcback
AsyncCallback

Дополнительный асинхронный ответный вызов по завершении операции записи.An optional asynchronous callback to be called when the write operation is complete.

asyncStatestate
Object

Предоставляемый пользователем объект, являющийся отличительным признаком данного конкретного запроса на асинхронную запись от других запросов.A user-provided object that distinguishes this particular asynchronous write request from other requests.

Возвращаемое значение

IAsyncResult

Объект, представляющий асинхронную операцию записи, которая может все еще быть отложена.An object that represents the asynchronous write operation, which could still be pending.

Исключения

Основной поток является null.The underlying stream is null.

-или--or- Основной поток закрыт.The underlying stream is closed.

Комментарии

Начиная с .NET Framework 4,5.NET Framework 4.5 , можно выполнять асинхронные операции записи с помощью Stream.WriteAsync метода.Starting with the .NET Framework 4,5.NET Framework 4.5, you can perform asynchronous write operations by using the Stream.WriteAsync method. BeginWriteМетод по-прежнему доступен в .NET Framework 4,5.NET Framework 4.5 для поддержки устаревшего кода. Однако асинхронные операции ввода-вывода можно легко реализовать с помощью новых асинхронных методов.The BeginWrite method is still available in .NET Framework 4,5.NET Framework 4.5 to support legacy code; however, you can implement asynchronous I/O operations more easily by using the new async methods. Дополнительные сведения см. в разделе Асинхронный файловый ввод-вывод.For more information, see Asynchronous File I/O.

BeginWriteМетод запускает асинхронную операцию записи в GZipStream объект потока.The BeginWrite method starts an asynchronous write operation to a GZipStream stream object.

Необходимо создать метод обратного вызова, реализующий AsyncCallback делегат, и передать его имя в BeginWrite метод.You must create a callback method that implements the AsyncCallback delegate and pass its name to the BeginWrite method.

Применяется к