RandomAccess Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt offsetbasierte APIs zum Lesen und Schreiben von Dateien auf threadsichere Weise bereit.
public ref class RandomAccess abstract sealedpublic static class RandomAccesstype RandomAccess = classPublic Class RandomAccess- Vererbung
-
RandomAccess
Hinweise
In .NET 10 und früheren Versionen unterstützen die Lese- und Schreibmethoden nur Dateien, die die Suche unterstützen.
Ab .NET 11 unterstützen die Lese- und Schreibmethoden auch nicht suchbare Ziehpunkte wie Rohre, Sockets und Zeichengeräte. Für diese Handles wird der fileOffset Parameter ignoriert, aber sein Wert muss weiterhin nicht negativ sein.
Verwenden Sie für Dateien, die such-, Lese- und Schreibvorgänge unterstützen, den angegebenen Offset, ohne die Dateiposition weiterzurücken. GetLength und SetLength erfordern ein Handle, das die Suche in allen Versionen unterstützt.
Methoden
| Name | Beschreibung |
|---|---|
| FlushToDisk(SafeFileHandle) |
Löscht die Betriebssystempuffer für die angegebene Datei auf den Datenträger. |
| GetLength(SafeFileHandle) |
Ruft die Länge der Datei in Bytes ab. |
| Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64) |
Liest eine Abfolge von Bytes aus der angegebenen Datei bei einem bestimmten Offset. |
| Read(SafeFileHandle, Span<Byte>, Int64) |
Liest eine Abfolge von Bytes aus der angegebenen Datei bei einem bestimmten Offset. |
| ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken) |
Liest eine Abfolge von Bytes aus der angegebenen Datei bei einem bestimmten Offset. |
| ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken) |
Liest eine Abfolge von Bytes aus der angegebenen Datei bei einem bestimmten Offset. |
| SetLength(SafeFileHandle, Int64) |
Legt die Länge der Datei auf den angegebenen Wert fest. |
| Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64) |
Schreibt eine Abfolge von Bytes aus bestimmten Puffern in die angegebene Datei bei einem bestimmten Offset. |
| Write(SafeFileHandle, ReadOnlySpan<Byte>, Int64) |
Schreibt eine Abfolge von Bytes aus dem angegebenen Puffer in die angegebene Datei bei einem bestimmten Offset. |
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
Schreibt eine Abfolge von Bytes aus bestimmten Puffern in die angegebene Datei bei einem bestimmten Offset. |
| WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken) |
Schreibt eine Abfolge von Bytes aus dem angegebenen Puffer in die angegebene Datei bei einem bestimmten Offset. |
