Taal

RandomAccess.Read Methode

Definitie

Overloads

Naam Description
Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)

Leest een reeks bytes uit het opgegeven bestand op een bepaalde offset.

Read(SafeFileHandle, Span<Byte>, Int64)

Leest een reeks bytes uit het opgegeven bestand op een bepaalde offset.

Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)

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 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 -> int64
Public Shared Function Read (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long) As Long

Parameters

handle
SafeFileHandle

De bestandsgreep.

buffers
IReadOnlyList<Memory<Byte>>

Een lijst met geheugenbuffers. Wanneer deze methode wordt geretourneerd, wordt de inhoud van de 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.

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.

Opmerkingen

Voor bestanden die ondersteuning bieden voor zoeken, is de bestandspositie niet geavanceerd.

Van toepassing op

Read(SafeFileHandle, Span<Byte>, Int64)

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 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 -> int
Public Shared Function Read (handle As SafeFileHandle, buffer As Span(Of Byte), fileOffset As Long) As Integer

Parameters

handle
SafeFileHandle

De bestandsgreep.

buffer
Span<Byte>

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.

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.

Opmerkingen

Voor bestanden die ondersteuning bieden voor zoeken, is de bestandspositie niet geavanceerd.

Van toepassing op