NegotiateStream.ReadAsync Método

Definição

Sobrecargas

Name Description
ReadAsync(Memory<Byte>, CancellationToken)

Lê dados de forma assíncrona a partir do NegotiateStream e armazena-os num intervalo de bytes de memória como uma operação assíncrona.

ReadAsync(Byte[], Int32, Int32, CancellationToken)

Lê dados de forma assíncrona deste fluxo e armazena-os no array especificado.

ReadAsync(Memory<Byte>, CancellationToken)

Origem:
NegotiateStream.cs
Origem:
NegotiateStream.cs
Origem:
NegotiateStream.cs
Origem:
NegotiateStream.cs
Origem:
NegotiateStream.cs

Lê dados de forma assíncrona a partir do NegotiateStream e armazena-os num intervalo de bytes de memória como uma operação assíncrona.

public override System.Threading.Tasks.ValueTask<int> ReadAsync(Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parâmetros

buffer
Memory<Byte>

O buffer para escrever os dados.

cancellationToken
CancellationToken

O token para monitorizar pedidos de cancelamento.

Devoluções

A ValueTask<TResult> que representa a operação de leitura assíncrona. O valor da sua Result propriedade contém o número total de bytes lidos em buffer.

Exceções

A operação de leitura falhou.

A autenticação não ocorreu.

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Observações

Este método lê assíncronamente todos os dados disponíveis buffer e devolve o número de bytes lidos com sucesso.

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

ReadAsync(Byte[], Int32, Int32, CancellationToken)

Origem:
NegotiateStream.cs
Origem:
NegotiateStream.cs
Origem:
NegotiateStream.cs
Origem:
NegotiateStream.cs
Origem:
NegotiateStream.cs

Lê dados de forma assíncrona deste fluxo e armazena-os no array especificado.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<int> ReadAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);
override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

Parâmetros

buffer
Byte[]

Um Byte array que recebe os bytes lidos do fluxo.

offset
Int32

A contendo Int32 a localização baseada em zero em buffer onde começar a armazenar os dados lidos deste fluxo.

count
Int32

A contendo Int32 o número máximo de bytes a ler do fluxo.

cancellationToken
CancellationToken

O token para monitorizar pedidos de cancelamento.

Devoluções

Um Int32 valor que especifica o número de bytes lidos do fluxo subjacente. Quando não há mais dados para ler, retorna 0.

Exceções

A operação de leitura falhou.

A autenticação não ocorreu.

Já está em curso uma Read(Byte[], Int32, Int32) operação.

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Observações

O método lê assíncronamente um máximo de count bytes do fluxo atual e armazena-os buffer a partir de .offset

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.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Read(Byte[], Int32, Int32).

Aplica-se a