NetworkStream.EndRead(IAsyncResult) Метод

Определение

Пространство имен:

System.Net.Sockets

Сборки:

netstandard.dll, System.Net.Sockets.dll

Исходный код:

NetworkStream.cs

Обрабатывает конец асинхронного чтения.

public:
 override int EndRead(IAsyncResult ^ asyncResult);

public override int EndRead(IAsyncResult asyncResult);

override this.EndRead : IAsyncResult -> int

Public Overrides Function EndRead (asyncResult As IAsyncResult) As Integer

Параметры

asyncResult

IAsyncResult

Объект, IAsyncResult представляющий асинхронный вызов.

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

Int32

Число байтов, считываемых из NetworkStreamнуля (0) и количества запрошенных байтов. Метод возвращает ноль (0) только в том случае, если запрашивались ноль байтов или если больше байтов не доступно, так как сокет однорангового узла выполнил корректное завершение работы. Если запрашиваются ноль байтов, операции чтения могут завершиться немедленно или не завершиться до тех пор, пока не будет доступен хотя бы один байт (но без использования данных).

Исключения

ArgumentException

Параметр asyncResult имеет значение null.

IOException

Базовый Socket объект закрыт.

–или–

При доступе к сокету произошла ошибка.

ObjectDisposedException

NetworkStream закрыт.

Комментарии

Это важно

Это API совместимости. Мы не рекомендуем использовать методы APM (Begin/End) для новой разработки. Вместо этого используйте эквиваленты на основе задач.

Метод EndRead завершает операцию чтения, запущенную методом BeginRead . Необходимо передать IAsyncResult созданный вызов сопоставления BeginRead . EndRead блокирует вызывающий поток до завершения операции.

Замечание

Если вы получаете IOExceptionсвойство, проверьте InnerException , было ли оно вызвано SocketException. В этом случае используйте ErrorCode свойство для получения определенного кода ошибки.

См. также раздел

• BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)