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
| Name | Beschreibung |
|---|---|
| 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. |
ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
Liest eine Abfolge von Bytes aus der angegebenen Datei bei einem bestimmten 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 der Speicherpuffer. Wenn diese Methode zurückgegeben wird, 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, das auf Abbruchanforderungen überwacht werden soll. Der Standardwert ist None.
Gibt zurück
Die Gesamtanzahl der in den Puffern gelesenen Bytes. Dies kann kleiner als die Anzahl der in den Puffern zugeordneten Bytes sein, wenn viele Bytes derzeit nicht verfügbar sind, oder Null (0), wenn das Ende der Datei erreicht wurde.
Ausnahmen
handle oder buffers ist null.
handle ist ungültig.
Die Datei wird geschlossen.
Die Datei unterstützt nicht die Suche (Pipe oder Socket).
fileOffset ist negativ.
handle wurde nicht zum Lesen geöffnet.
Ein E/A-Fehler ist aufgetreten.
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 Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64).
Gilt für:
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
Liest eine Abfolge von Bytes aus der angegebenen Datei bei einem bestimmten 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 Speicherbereich. Wenn diese Methode zurückgegeben wird, werden die Inhalte dieses Bereichs durch die aus der Datei gelesenen Bytes ersetzt.
- fileOffset
- Int64
Die Dateiposition, aus der gelesen werden soll.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll. Der Standardwert ist None.
Gibt zurück
Die Gesamtanzahl der in den Puffer gelesenen Bytes. Dies kann kleiner als die Anzahl der im Puffer zugewiesenen Bytes sein, wenn viele Bytes derzeit nicht verfügbar sind, oder Null (0), wenn das Ende der Datei erreicht wurde.
Ausnahmen
handle ist null.
handle ist ungültig.
Die Datei wird geschlossen.
Die Datei unterstützt nicht die Suche (Pipe oder Socket).
fileOffset ist negativ.
handle wurde nicht zum Lesen geöffnet.
Ein E/A-Fehler ist aufgetreten.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Die Position der Datei ist nicht erweitert.
