RandomAccess Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapewnia interfejsy API oparte na przesunięciach do odczytywania i zapisywania plików w bezpieczny wątkowo sposób.
public ref class RandomAccess abstract sealed
public static class RandomAccess
type RandomAccess = class
Public Class RandomAccess
- Dziedziczenie
-
RandomAccess
Uwagi
W .NET 10 i starszych wersjach metody odczytu i zapisu obsługują tylko pliki, które obsługują wyszukiwanie.
Począwszy od .NET 11, metody odczytu i zapisu obsługują również nienależące do wyszukiwania dojścia, takie jak potoki, gniazda i urządzenia znakowe. W przypadku tych dojść fileOffset parametr jest ignorowany, ale jego wartość musi być nadal nieujemna.
W przypadku plików, które obsługują wyszukiwanie, operacje odczytu i zapisu używają określonego przesunięcia bez zwiększania pozycji pliku. GetLength i SetLength wymagają uchwytu, który obsługuje wyszukiwanie we wszystkich wersjach.
Metody
| Nazwisko | Opis |
|---|---|
| FlushToDisk(SafeFileHandle) |
Opróżnia bufory systemu operacyjnego dla danego pliku na dysk. |
| GetLength(SafeFileHandle) |
Pobiera długość pliku w bajtach. |
| Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64) |
Odczytuje sekwencję bajtów z danego pliku z danego przesunięcia. |
| Read(SafeFileHandle, Span<Byte>, Int64) |
Odczytuje sekwencję bajtów z danego pliku z danego przesunięcia. |
| ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken) |
Odczytuje sekwencję bajtów z danego pliku z danego przesunięcia. |
| ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken) |
Odczytuje sekwencję bajtów z danego pliku z danego przesunięcia. |
| SetLength(SafeFileHandle, Int64) |
Ustawia długość pliku na daną wartość. |
| Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64) |
Zapisuje sekwencję bajtów z podanych buforów do danego pliku z danym przesunięciem. |
| Write(SafeFileHandle, ReadOnlySpan<Byte>, Int64) |
Zapisuje sekwencję bajtów z danego buforu do danego pliku z danym przesunięciem. |
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
Zapisuje sekwencję bajtów z podanych buforów do danego pliku z danym przesunięciem. |
| WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken) |
Zapisuje sekwencję bajtów z danego buforu do danego pliku z danym przesunięciem. |