PipeStream.EndRead(IAsyncResult) Método

Definição

Encerra uma solicitação de leitura assíncrona pendente.Ends a pending asynchronous read request.

public:
 override int EndRead(IAsyncResult ^ asyncResult);
public override int EndRead (IAsyncResult asyncResult);
[System.Security.SecurityCritical]
public override int EndRead (IAsyncResult asyncResult);
override this.EndRead : IAsyncResult -> int
[<System.Security.SecurityCritical>]
override this.EndRead : IAsyncResult -> int
Public Overrides Function EndRead (asyncResult As IAsyncResult) As Integer

Parâmetros

asyncResult
IAsyncResult

A referência à solicitação assíncrona pendente.The reference to the pending asynchronous request.

Retornos

Int32

O número de bytes que foram lidos.The number of bytes that were read. O valor retornado de 0 indica o fim do fluxo (o pipe foi fechado).A return value of 0 indicates the end of the stream (the pipe has been closed).

Atributos

Exceções

asyncResult é null.asyncResult is null.

asyncResult não é proveniente de um método BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) no fluxo atual.asyncResult did not originate from a BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) method on the current stream.

O fluxo está fechado ou ocorreu um erro interno.The stream is closed or an internal error has occurred.

Comentários

Esse método retorna o número de bytes lidos na matriz de bytes especificada pela chamada anterior para BeginRead .This method returns the number of bytes read into the byte array specified by the earlier call to BeginRead.

Passe o IAsyncResult objeto retornado para o EndRead método para determinar quantos bytes foram lidos e para liberar os recursos do sistema operacional usados para leitura.Pass the returned IAsyncResult object to the EndRead method to determine how many bytes were read and to release operating system resources used for reading. EndRead deve ser chamado uma vez para cada chamada para BeginRead .EndRead must be called once for every call to BeginRead. Isso pode ser feito no mesmo código chamado BeginRead ou em um retorno de chamada que é passado para BeginRead .This can be done either in the same code that called BeginRead or in a callback that is passed to BeginRead.

Use a CanRead propriedade para determinar se o PipeStream objeto atual oferece suporte a operações de leitura.Use the CanRead property to determine whether the current PipeStream object supports read operations.

Se o pipe for fechado ou um argumento inválido for passado para BeginRead , as exceções apropriadas serão geradas imediatamente.If the pipe is closed or an invalid argument is passed to BeginRead, the appropriate exceptions are raised immediately. Os erros que ocorrem durante uma solicitação de leitura assíncrona ocorrem no thread do pool de threads que está executando a solicitação.Errors that occur during an asynchronous read request occur on the thread pool thread that is performing the request. As exceções são geradas quando o código chama o EndRead método.The exceptions are raised when the code calls the EndRead method.

Aplica-se a