Stream.ReadExactlyAsync 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 |
|---|---|
| ReadExactlyAsync(Memory<Byte>, CancellationToken) |
Lê assíncronamente bytes do fluxo atual, avança a posição dentro do fluxo até que este |
| ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken) |
Lê |
ReadExactlyAsync(Memory<Byte>, CancellationToken)
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
Lê assíncronamente bytes do fluxo atual, avança a posição dentro do fluxo até que este buffer seja preenchido e monitoriza pedidos de cancelamento.
public System.Threading.Tasks.ValueTask ReadExactlyAsync(Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);member this.ReadExactlyAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ReadExactlyAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParâmetros
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento.
Devoluções
Uma tarefa que representa a operação de leitura assíncrona.
Exceções
O fim do fluxo é alcançado antes de preencher o buffer.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Quando buffer estiver vazia, esta operação de leitura será concluída sem esperar pelos dados disponíveis no fluxo.
Aplica-se a
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
Lê count assíncronamente o número de bytes do fluxo atual, avança a posição dentro do fluxo e monitoriza pedidos de cancelamento.
public System.Threading.Tasks.ValueTask ReadExactlyAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken = default);member this.ReadExactlyAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ReadExactlyAsync (buffer As Byte(), offset As Integer, count As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParâmetros
- buffer
- Byte[]
O buffer para escrever os dados.
- offset
- Int32
O desvio de bytes para buffer onde começar a escrever dados do fluxo.
- count
- Int32
O número de bytes a ser lido do fluxo atual.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento.
Devoluções
Uma tarefa que representa a operação de leitura assíncrona.
Exceções
buffer é null.
offset está fora dos limites de buffer.
-ou-
count é negativo.
-ou-
O alcance especificado pela combinação de offset e count excede o comprimento de buffer.
O fim do fluxo é alcançado antes de ler count o número de bytes.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Quando count é 0 (zero), esta operação de leitura será concluída sem esperar pelos dados disponíveis no fluxo.
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 ReadExactly(Byte[], Int32, Int32).
