RandomAccess Classe
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.
Fornece APIs baseadas em offset para ler e escrever ficheiros de forma segura para threads.
public ref class RandomAccess abstract sealedpublic static class RandomAccesstype RandomAccess = classPublic Class RandomAccess- Herança
-
RandomAccess
Observações
No .NET 10 e versões anteriores, os métodos de leitura e escrita suportam apenas ficheiros que suportam busca.
A partir do .NET 11, os métodos de leitura e escrita também suportam handles não procuráveis, como pipes, sockets e dispositivos de caracteres. Para estes handles, o fileOffset parâmetro é ignorado, mas o seu valor deve continuar a ser não negativo.
Para ficheiros que suportam operações de procura, leitura e escrita utilizam o deslocamento especificado sem avançar a posição do ficheiro. GetLength e SetLength exigem um handle que suporte a busca em todas as versões.
Métodos
| Nome | Descrição |
|---|---|
| FlushToDisk(SafeFileHandle) |
Limpa os buffers do sistema operativo para o ficheiro dado para o disco. |
| GetLength(SafeFileHandle) |
Obtém o comprimento do ficheiro em bytes. |
| Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64) |
Lê uma sequência de bytes do ficheiro dado no deslocamento indicado. |
| Read(SafeFileHandle, Span<Byte>, Int64) |
Lê uma sequência de bytes do ficheiro dado no deslocamento indicado. |
| 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. |
| SetLength(SafeFileHandle, Int64) |
Define o comprimento do ficheiro para o valor indicado. |
| Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64) |
Escreve uma sequência de bytes a partir de buffers dados para ficheiro dado com um determinado deslocamento. |
| Write(SafeFileHandle, ReadOnlySpan<Byte>, Int64) |
Escreve uma sequência de bytes do buffer dado para o ficheiro dado no deslocamento indicado. |
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
Escreve uma sequência de bytes a partir de buffers dados para ficheiro dado com um determinado deslocamento. |
| WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken) |
Escreve uma sequência de bytes do buffer dado para o ficheiro dado no deslocamento indicado. |
