SslStream.ReadAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| ReadAsync(Memory<Byte>, CancellationToken) |
A leitura assíncrona os dados deste fluxo e armazena-os na faixa de memória especificada. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
A leitura assíncrona dados deste fluxo e armazena-os no intervalo especificado de um array de bytes. |
ReadAsync(Memory<Byte>, CancellationToken)
A leitura assíncrona os dados deste fluxo e armazena-os na faixa de memória especificada.
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
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento.
Devoluções
Uma tarefa 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. Quando não há mais dados para ler, retorna 0.
Exceções
A autenticação não ocorreu.
A operação de leitura falhou. Verifique a exceção interna, se estiver presente, para determinar a causa da falha.
Já está em curso uma operação de leitura.
Este objeto foi encerrado.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Este método lê tantos dados quanto estiver disponível no buffer.
Não pode realizar múltiplas operações de leitura simultâneas.
Não pode chamar este método até ter autenticado com sucesso.
Aplica-se a
ReadAsync(Byte[], Int32, Int32, CancellationToken)
A leitura assíncrona dados deste fluxo e armazena-os no intervalo especificado de um array de bytes.
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[]
O buffer que recebe os bytes lidos deste fluxo.
- offset
- Int32
A localização baseada em zero onde buffer começar a armazenar os dados lidos deste fluxo.
- count
- Int32
O número máximo de bytes a ler deste fluxo.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento.
Devoluções
Uma tarefa 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. Quando não há mais dados para ler, retorna 0.
Exceções
buffer é null.
offset é inferior a 0.
-ou-
count é inferior a 0.
-ou-
count é maior que o comprimento de buffer menos offset.
A autenticação não ocorreu.
A operação de leitura falhou. Verifique a exceção interna, se estiver presente, para determinar a causa da falha.
Já está em curso uma operação de leitura.
Este objeto foi encerrado.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
O método lê um máximo de count bytes do fluxo e armazena-os buffer a partir de .offset
Não pode realizar múltiplas operações de leitura simultâneas.
Não pode chamar este método até ter autenticado com sucesso.
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).