SslStream.ReadAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| ReadAsync(Memory<Byte>, CancellationToken) |
Lê de forma assíncrona os dados desse fluxo e os armazena no intervalo de memória especificado. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Lê de forma assíncrona os dados desse fluxo e os armazena no intervalo especificado de uma matriz de bytes. |
ReadAsync(Memory<Byte>, CancellationToken)
Lê de forma assíncrona os dados desse fluxo e os armazena no intervalo de memória especificado.
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 a ser monitorado para solicitações de cancelamento.
Retornos
Uma tarefa que representa a operação de leitura assíncrona. O valor de sua Result propriedade contém o número total de bytes lidos em buffer. Quando não houver mais dados a serem lidos, retornará 0.
Exceções
A autenticação não ocorreu.
Falha na operação de leitura. Verifique a exceção interna, se ela estiver presente, para determinar a causa da falha.
Já há uma operação de leitura em andamento.
Este objeto foi fechado.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esse método lê o máximo de dados que está disponível no buffer.
Você não pode executar várias operações de leitura simultâneas.
Você não pode chamar esse método até que tenha se autenticado com êxito.
Aplica-se a
ReadAsync(Byte[], Int32, Int32, CancellationToken)
Lê de forma assíncrona os dados desse fluxo e os armazena no intervalo especificado de uma matriz 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 desse fluxo.
- offset
- Int32
O local baseado em zero no buffer qual começar a armazenar os dados lidos desse fluxo.
- count
- Int32
O número máximo de bytes a serem lidos desse fluxo.
- cancellationToken
- CancellationToken
O token a ser monitorado para solicitações de cancelamento.
Retornos
Uma tarefa que representa a operação de leitura assíncrona. O valor de sua Result propriedade contém o número total de bytes lidos em buffer. Quando não houver mais dados a serem lidos, retornará 0.
Exceções
buffer é null.
offset é menor que 0.
-ou-
count é menor que 0.
-ou-
count é maior que o comprimento de buffer menos offset.
A autenticação não ocorreu.
Falha na operação de leitura. Verifique a exceção interna, se ela estiver presente, para determinar a causa da falha.
Já há uma operação de leitura em andamento.
Este objeto foi fechado.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
O método lê um máximo de count bytes do fluxo e os armazena no buffer início em offset.
Você não pode executar várias operações de leitura simultâneas.
Você não pode chamar esse método até que tenha se autenticado com êxito.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Read(Byte[], Int32, Int32).