Idioma

RandomAccess Classe

Definição

Fornece APIs baseadas em deslocamento para ler e gravar arquivos de maneira thread-safe.

public ref class RandomAccess abstract sealed
public static class RandomAccess
type RandomAccess = class
Public Class RandomAccess
Herança
RandomAccess

Comentários

No .NET 10 e versões anteriores, os métodos de leitura e gravação dão suporte apenas a arquivos que dão suporte à busca.

A partir do .NET 11, os métodos de leitura e gravação também dão suporte a identificadores não procurados, como pipes, soquetes e dispositivos de caractere. Para esses identificadores, o fileOffset parâmetro é ignorado, mas seu valor ainda deve ser não negativo.

Para arquivos que dão suporte a operações de busca, leitura e gravação, use o deslocamento especificado sem avançar na posição do arquivo. GetLength e SetLength exigir um identificador que dê suporte à busca em todas as versões.

Métodos

Nome Description
FlushToDisk(SafeFileHandle)

Libera os buffers do sistema operacional para o arquivo fornecido no disco.

GetLength(SafeFileHandle)

Obtém o comprimento do arquivo em bytes.

Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)

Lê uma sequência de bytes de determinado arquivo em determinado deslocamento.

Read(SafeFileHandle, Span<Byte>, Int64)

Lê uma sequência de bytes de determinado arquivo em determinado deslocamento.

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)

Lê uma sequência de bytes de determinado arquivo em determinado deslocamento.

ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)

Lê uma sequência de bytes de determinado arquivo em determinado deslocamento.

SetLength(SafeFileHandle, Int64)

Define o comprimento do arquivo como o valor fornecido.

Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64)

Grava uma sequência de bytes de determinados buffers em determinado arquivo em determinado deslocamento.

Write(SafeFileHandle, ReadOnlySpan<Byte>, Int64)

Grava uma sequência de bytes de determinado buffer em determinado arquivo em determinado deslocamento.

WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)

Grava uma sequência de bytes de determinados buffers em determinado arquivo em determinado deslocamento.

WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)

Grava uma sequência de bytes de determinado buffer em determinado arquivo em determinado deslocamento.

Aplica-se a

Confira também