RandomAccess.Read 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 |
|---|---|
| Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64) |
Läser en sekvens med byte från angiven fil vid given förskjutning. |
| Read(SafeFileHandle, Span<Byte>, Int64) |
Läser en sekvens med byte från angiven fil vid given förskjutning. |
Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)
- 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 long Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::Collections::Generic::IReadOnlyList<Memory<System::Byte>> ^ buffers, long fileOffset);public static long Read(Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset);static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 -> int64Public Shared Function Read (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long) As LongParametrar
- handle
- SafeFileHandle
Filhandtaget.
- buffers
- IReadOnlyList<Memory<Byte>>
En lista över minnesbuffertar. När den här metoden returnerar ersätts innehållet i buffertarna 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.
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.
Kommentarer
För filer som stöder sökning är filpositionen inte avancerad.
Gäller för
Read(SafeFileHandle, Span<Byte>, Int64)
- 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 int Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, Span<System::Byte> buffer, long fileOffset);public static int Read(Microsoft.Win32.SafeHandles.SafeFileHandle handle, Span<byte> buffer, long fileOffset);static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * Span<byte> * int64 -> intPublic Shared Function Read (handle As SafeFileHandle, buffer As Span(Of Byte), fileOffset As Long) As IntegerParametrar
- 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.
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.
Kommentarer
För filer som stöder sökning är filpositionen inte avancerad.
