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.
count больше количества байтов, доступных в buffer.
Канал закрыт.
Канал не поддерживает операции записи.
Канал отключен, ожидает подключения или дескриптор не задан.
Канал поврежден или произошла другая ошибка ввода-вывода.
Комментарии
EndWrite необходимо вызывать один раз для каждого вызова BeginWrite. Это можно сделать либо в том же коде, который вызывается BeginWrite , либо в обратном вызове, передаваемом в BeginWrite.
CanWrite Используйте свойство, чтобы определить, поддерживает ли текущий PipeStream объект операции записи.
Если канал закрыт или недопустимый аргумент передается BeginWrite, соответствующие исключения возникают немедленно. Ошибки, возникающие во время асинхронного запроса на запись, происходят в потоке пула потоков, выполняющего запрос. Исключения возникают при вызове EndWrite метода кодом.