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 -> 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, с которого начинается копирование байтов в текущий поток.
- count
- Int32
Максимальное число байтов для записи.
- callback
- AsyncCallback
Метод, вызываемый после завершения операции асинхронной записи.
- state
- Object
Предоставляемый пользователем объект, являющийся отличительным признаком данного конкретного запроса на асинхронную запись от других запросов.
Возвращаемое значение
Объект IAsyncResult, который ссылается на операцию асинхронной записи.
- Атрибуты
Исключения
buffer имеет значение null.
Значение параметраoffset меньше 0.
-или-
Значение параметраcount меньше 0.
count больше, чем число байтов, доступных в buffer.
Канал закрыт.
Канал не поддерживает операции записи.
Канал отключен, ожидает подключения, или дескриптор не был задан.
Канал разорван, или возникла другая ошибка ввода-вывода.
Комментарии
EndWrite должен вызываться один раз для каждого вызова BeginWrite. Это можно сделать либо в том же коде, который вызвал BeginWrite , либо в обратном вызове, передаваемом в BeginWrite.
Используйте свойство , CanWrite чтобы определить, поддерживает ли текущий PipeStream объект операции записи.
Если канал закрыт или в передается BeginWriteнедопустимый аргумент , соответствующие исключения создаются немедленно. Ошибки, возникающие во время асинхронного запроса на запись, происходят в потоке пула потоков, который выполняет запрос. Исключения возникают, когда код вызывает EndWrite метод .
