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

Ссылка

Определение

Пространство имен:: System.IO.Pipes

Сборка:: System.IO.Pipes.dll

Сборка:: System.Core.dll

Сборка:: netstandard.dll

Исходный код:: PipeStream.Unix.cs

Исходный код:: PipeStream.Unix.cs

Исходный код:: PipeStream.Unix.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Начинает операцию асинхронного чтения.

public:
 override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);

public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);

public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback callback, object state);

[System.Security.SecurityCritical]
public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback callback, object state);

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

[<System.Security.SecurityCritical>]
override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult

Public Overrides Function BeginRead (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

Объект IAsyncResult, который ссылается на асинхронное чтение.

Атрибуты: SecurityCriticalAttribute

Исключения

ArgumentNullException

buffer имеет значение null.

ArgumentOutOfRangeException

Значение параметраoffset меньше 0.

-или-

Значение параметраcount меньше 0.

ArgumentException

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

ObjectDisposedException

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

NotSupportedException

Этот канал не поддерживает операции чтения.

InvalidOperationException

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

IOException

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

Передайте возвращенный IAsyncResult объект методу EndRead , чтобы определить, сколько байтов было прочитано, и освободить ресурсы операционной системы, используемые для чтения. EndRead должен вызываться один раз для каждого вызова BeginRead. Это можно сделать либо в том же коде, который вызвал BeginRead , либо в обратном вызове, передаваемом в BeginRead.

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

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

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

Поделиться через