NegotiateStream.EndRead(IAsyncResult) Método

Definição

Termina uma operação de leitura assíncrona que foi iniciada com uma chamada para BeginRead(Byte[], Int32, Int32, AsyncCallback, Object).

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

Parâmetros

asyncResult
IAsyncResult

Uma IAsyncResult instância devolvida por uma chamada para BeginRead(Byte[], Int32, Int32, AsyncCallback, Object).

Devoluções

Um Int32 valor que especifica o número de bytes lidos do fluxo subjacente.

Exceções

asyncResult é null.

O asyncResult não foi criado por uma chamada para BeginRead(Byte[], Int32, Int32, AsyncCallback, Object).

Não há nenhuma operação de leitura pendente para completar.

-ou-

A autenticação não ocorreu.

A operação de leitura falhou.

Exemplos

O exemplo de código seguinte demonstra o fim de uma operação de leitura assíncrona. Para um exemplo que demonstre o início da operação, veja BeginRead.

private static void EndReadCallback(ClientState cState, int bytes)
{
    NegotiateStream authStream = (NegotiateStream)cState.AuthenticatedStream;
    // Read the client message.
    try
    {
        cState.Message.Append(Encoding.UTF8.GetChars(cState.Buffer, 0, bytes));
        if (bytes != 0)
        {
            Task<int> readTask = authStream.ReadAsync(cState.Buffer, 0, cState.Buffer.Length);
            readTask
                .ContinueWith(task => { EndReadCallback(cState, task.Result); })
                .Wait();

            return;
        }
    }
    catch (Exception e)
    {
        // A real application should do something
        // useful here, such as logging the failure.
        Console.WriteLine("Client message exception:");
        Console.WriteLine(e);
        return;
    }
    IIdentity id = authStream.RemoteIdentity;
    Console.WriteLine("{0} says {1}", id.Name, cState.Message.ToString());
}

Observações

Se a operação não estiver concluída, este método bloqueia até que termine.

Para realizar esta operação de forma síncrona, use o Read método.

Não pode chamar este método até ter autenticado com sucesso. Para autenticar, chame um dos AuthenticateAsClient, AuthenticateAsClientAsync, BeginAuthenticateAsClient, AuthenticateAsServer, AuthenticateAsServerAsync, ou BeginAuthenticateAsServer métodos.

Aplica-se a