RandomAccess.ReadAsync Methode
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.
Überlädt
| ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken) |
Liest eine Bytesequenz aus einer bestimmten Datei am angegebenen Offset. |
| ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken) |
Liest eine Bytesequenz aus einer bestimmten Datei am angegebenen Offset. |
ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
Liest eine Bytesequenz aus einer bestimmten Datei am angegebenen Offset.
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)Parameter
- handle
- SafeFileHandle
Das Dateihandle.
- buffers
- IReadOnlyList<Memory<Byte>>
Eine Liste von Speicherpuffern. Wenn diese Methode zurückgibt, werden die Inhalte dieser Puffer durch die aus der Datei gelesenen Bytes ersetzt.
- fileOffset
- Int64
Die Dateiposition, aus der gelesen werden soll.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Die Gesamtzahl der Bytes, die in die Puffer gelesen werden. Dies kann kleiner als die Anzahl der in den Puffern zugeordneten Bytes sein, wenn diese Anzahl von Bytes derzeit nicht verfügbar ist, oder null (0), wenn das Ende der Datei erreicht wurde.
Ausnahmen
handle oder buffers ist null.
handle ist ungültig.
Die Datei ist geschlossen.
Die Datei unterstützt keine Suche (Pipe oder Socket).
fileOffset ist ein negativer Wert.
handle wurde nicht zum Lesen geöffnet.
E/A-Fehler
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Die Position der Datei ist nicht erweitert.
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64).
Gilt für:
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
Liest eine Bytesequenz aus einer bestimmten Datei am angegebenen Offset.
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)Parameter
- handle
- SafeFileHandle
Das Dateihandle.
Ein Bereich im Arbeitsspeicher. Wenn diese Methode zurückgibt, wird der Inhalt dieses Bereichs durch die aus der Datei gelesenen Bytes ersetzt.
- fileOffset
- Int64
Die Dateiposition, aus der gelesen werden soll.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Die Gesamtanzahl der in den Puffer gelesenen Bytes. Dies kann kleiner als die Anzahl der im Puffer zugeordneten Bytes sein, wenn diese Anzahl von Bytes derzeit nicht verfügbar ist, oder null (0), wenn das Ende der Datei erreicht wurde.
Ausnahmen
handle ist null.
handle ist ungültig.
Die Datei ist geschlossen.
Die Datei unterstützt keine Suche (Pipe oder Socket).
fileOffset ist ein negativer Wert.
handle wurde nicht zum Lesen geöffnet.
E/A-Fehler
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Die Position der Datei ist nicht erweitert.
