RandomAccess.ReadAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Överlagringar
| Name | Description |
|---|---|
| ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken) |
Läser en sekvens med byte från angiven fil vid given förskjutning. |
| ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken) |
Läser en sekvens med byte från angiven fil vid given förskjutning. |
ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
Läser en sekvens med byte från angiven fil vid given förskjutning.
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)Parametrar
- handle
- SafeFileHandle
Filhandtaget.
- buffers
- IReadOnlyList<Memory<Byte>>
En lista över minnesbuffertar. När den här metoden returnerar ersätts innehållet i dessa buffertar med de byte som läss från filen.
- fileOffset
- Int64
Filpositionen som ska läsas från. I .NET 11 och senare versioner ignoreras den här parametern för filer som inte stöder sökning, till exempel rör, socketar och teckenenheter. Värdet måste vara icke-negativt även när det ignoreras.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
Det totala antalet byte som lästs in i buffertarna. Detta kan vara mindre än antalet byte som allokerats i buffertarna om så många byte för närvarande inte är tillgängliga eller noll (0) om slutet av filen har nåtts.
Undantag
handle eller buffers är null.
handle är ogiltigt.
Filen är stängd.
I .NET 10 och tidigare versioner stöder filen inte sökning (till exempel ett rör eller en socket).
fileOffset är negativ.
handle inte öppnades för läsning.
Ett I/O-fel uppstod.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
För filer som stöder sökning är filpositionen inte avancerad.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64).
Gäller för
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
- Källa:
- RandomAccess.cs
Läser en sekvens med byte från angiven fil vid given förskjutning.
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)Parametrar
- handle
- SafeFileHandle
Filhandtaget.
En region med minne. När den här metoden returnerar ersätts innehållet i den här regionen med de byte som lästs från filen.
- fileOffset
- Int64
Filpositionen som ska läsas från. I .NET 11 och senare versioner ignoreras den här parametern för filer som inte stöder sökning, till exempel rör, socketar och teckenenheter. Värdet måste vara icke-negativt även när det ignoreras.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
Det totala antalet byte som lästs in i bufferten. Detta kan vara mindre än antalet byte som allokerats i bufferten om så många byte för närvarande inte är tillgängliga eller noll (0) om slutet av filen har nåtts.
Undantag
handle är null.
handle är ogiltigt.
Filen är stängd.
I .NET 10 och tidigare versioner stöder filen inte sökning (till exempel ett rör eller en socket).
fileOffset är negativ.
handle inte öppnades för läsning.
Ett I/O-fel uppstod.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
För filer som stöder sökning är filpositionen inte avancerad.
