RandomAccess.ReadAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| Naam | Description |
|---|---|
| ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken) |
Leest een reeks bytes uit het opgegeven bestand op een bepaalde offset. |
| ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken) |
Leest een reeks bytes uit het opgegeven bestand op een bepaalde offset. |
ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
Leest een reeks bytes uit het opgegeven bestand op een bepaalde 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)Parameters
- handle
- SafeFileHandle
De bestandsgreep.
- buffers
- IReadOnlyList<Memory<Byte>>
Een lijst met geheugenbuffers. Wanneer deze methode wordt geretourneerd, wordt de inhoud van deze buffers vervangen door de bytes die uit het bestand zijn gelezen.
- fileOffset
- Int64
De positie van het bestand waaruit moet worden gelezen. In .NET 11 en latere versies wordt deze parameter genegeerd voor bestanden die geen ondersteuning bieden voor zoeken, zoals pijpen, sockets en tekenapparaten. De waarde moet niet-negatief zijn, zelfs als deze wordt genegeerd.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Het totale aantal bytes dat in de buffers is gelezen. Dit kan kleiner zijn dan het aantal bytes dat in de buffers is toegewezen als er momenteel veel bytes niet beschikbaar zijn of nul (0) als het einde van het bestand is bereikt.
Uitzonderingen
handle of buffers is null.
handle is ongeldig.
Het bestand is gesloten.
In .NET 10 en eerdere versies biedt het bestand geen ondersteuning voor zoeken (bijvoorbeeld een pijp of socket).
fileOffset is negatief.
handle is niet geopend voor lezen.
Er is een I/O-fout opgetreden.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Voor bestanden die ondersteuning bieden voor zoeken, is de bestandspositie niet geavanceerd.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
- Bron:
- RandomAccess.cs
Leest een reeks bytes uit het opgegeven bestand op een bepaalde 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)Parameters
- handle
- SafeFileHandle
De bestandsgreep.
Een geheugengebied. Wanneer deze methode wordt geretourneerd, wordt de inhoud van deze regio vervangen door de bytes die uit het bestand zijn gelezen.
- fileOffset
- Int64
De positie van het bestand waaruit moet worden gelezen. In .NET 11 en latere versies wordt deze parameter genegeerd voor bestanden die geen ondersteuning bieden voor zoeken, zoals pijpen, sockets en tekenapparaten. De waarde moet niet-negatief zijn, zelfs als deze wordt genegeerd.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Het totale aantal bytes dat in de buffer is gelezen. Dit kan kleiner zijn dan het aantal toegewezen bytes in de buffer als dat aantal bytes momenteel niet beschikbaar is of nul (0) als het einde van het bestand is bereikt.
Uitzonderingen
handle is null.
handle is ongeldig.
Het bestand is gesloten.
In .NET 10 en eerdere versies biedt het bestand geen ondersteuning voor zoeken (bijvoorbeeld een pijp of socket).
fileOffset is negatief.
handle is niet geopend voor lezen.
Er is een I/O-fout opgetreden.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Voor bestanden die ondersteuning bieden voor zoeken, is de bestandspositie niet geavanceerd.
