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

Определение

Начинает асинхронную операцию записи.

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);
[System.Security.SecurityCritical]
public override IAsyncResult BeginWrite(byte[] buffer, int offset, int count, AsyncCallback callback, object state);
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
[<System.Security.SecurityCritical>]
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 , ссылающийся на асинхронную операцию записи.

Атрибуты

Исключения

buffer равно null.

offset меньше 0.

–или–

count меньше 0.

count больше количества байтов, доступных в buffer.

Канал закрыт.

Канал не поддерживает операции записи.

Канал отключен, ожидает подключения или дескриптор не задан.

Канал поврежден или произошла другая ошибка ввода-вывода.

Комментарии

EndWrite необходимо вызывать один раз для каждого вызова BeginWrite. Это можно сделать либо в том же коде, который вызывается BeginWrite , либо в обратном вызове, передаваемом в BeginWrite.

CanWrite Используйте свойство, чтобы определить, поддерживает ли текущий PipeStream объект операции записи.

Если канал закрыт или недопустимый аргумент передается BeginWrite, соответствующие исключения возникают немедленно. Ошибки, возникающие во время асинхронного запроса на запись, происходят в потоке пула потоков, выполняющего запрос. Исключения возникают при вызове EndWrite метода кодом.

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