RandomAccess.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(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken) |
Lê uma sequência de bytes do ficheiro dado no deslocamento indicado. |
| ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken) |
Lê uma sequência de bytes do ficheiro dado no deslocamento indicado. |
ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
Lê uma sequência de bytes do ficheiro dado no deslocamento indicado.
public static System.Threading.Tasks.ValueTask<long> ReadAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int64>Public Shared Function ReadAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Long)Parâmetros
- handle
- SafeFileHandle
A alça do ficheiro.
- buffers
- IReadOnlyList<Memory<Byte>>
Uma lista de buffers de memória. Quando este método retorna, o conteúdo destes buffers é substituído pelos bytes lidos do ficheiro.
- fileOffset
- Int64
A posição do ficheiro para ler.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
O número total de bytes lidos nos buffers. Isto pode ser inferior ao número de bytes alocados nos buffers se esse número de bytes não estiver disponível no momento, ou zero (0) se o fim do ficheiro for alcançado.
Exceções
handle ou buffers é null.
handle é inválido.
O processo está encerrado.
O ficheiro não suporta busca (pipe ou socket).
fileOffset é negativo.
handle não estava aberto para leitura.
Ocorreu um erro de I/O.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
A posição do dossier não está avançada.
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(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64).
Aplica-se a
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
Lê uma sequência de bytes do ficheiro dado no deslocamento indicado.
public static System.Threading.Tasks.ValueTask<int> ReadAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, Memory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * Memory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>Public Shared Function ReadAsync (handle As SafeFileHandle, buffer As Memory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)Parâmetros
- handle
- SafeFileHandle
A alça do ficheiro.
Uma região da memória. Quando este método retorna, o conteúdo desta região é substituído pelos bytes lidos do ficheiro.
- fileOffset
- Int64
A posição do ficheiro para ler.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
O número total de bytes lidos no buffer. Isto pode ser inferior ao número de bytes alocados no buffer se esse número de bytes não estiverem disponíveis no momento, ou zero (0) se o fim do ficheiro for atingido.
Exceções
handle é null.
handle é inválido.
O processo está encerrado.
O ficheiro não suporta busca (pipe ou socket).
fileOffset é negativo.
handle não estava aberto para leitura.
Ocorreu um erro de I/O.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
A posição do dossier não está avançada.
