RandomAccess.Read Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.Runtime.dll

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

Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)	Liest eine Bytesequenz aus der angegebenen Datei am angegebenen Offset.
Read(SafeFileHandle, Span<Byte>, Int64)	Liest eine Bytesequenz aus der angegebenen Datei am angegebenen Offset.

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

Quelle:: RandomAccess.cs

Quelle:: RandomAccess.cs

Quelle:: RandomAccess.cs

Liest eine Bytesequenz aus der angegebenen Datei am angegebenen 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

Parameter

handle: SafeFileHandle

Das Dateihandle.

buffers: IReadOnlyList<Memory<Byte>>

Eine Liste von Speicherpuffern. Wenn diese Methode zurückgibt, werden die Inhalte der Puffer durch die aus der Datei gelesenen Bytes ersetzt.

fileOffset: Int64

Die Dateiposition, aus der gelesen werden soll.

Gibt zurück

Int64

Die Gesamtanzahl von Bytes, die in die Puffer eingelesen werden. Dies kann kleiner als die Anzahl der Bytes sein, die in den Puffern zugewiesen werden, wenn viele Bytes derzeit nicht verfügbar sind, oder null (0), wenn das Ende der Datei erreicht wurde.

Ausnahmen

ArgumentNullException

handle oder buffers ist null.

ArgumentException

handle ist ungültig.

ObjectDisposedException

Die Datei ist geschlossen.

NotSupportedException

Die Datei unterstützt keine Suche (Pipe oder Socket).

ArgumentOutOfRangeException

fileOffset ist ein negativer Wert.

UnauthorizedAccessException

handle wurde nicht zum Lesen geöffnet.

IOException

E/A-Fehler

Hinweise

Die Position der Datei ist nicht erweitert.

Gilt für:

Read(SafeFileHandle, Span<Byte>, Int64)

Quelle:: RandomAccess.cs

Quelle:: RandomAccess.cs

Quelle:: RandomAccess.cs

Liest eine Bytesequenz aus der angegebenen Datei am angegebenen 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

Parameter

handle: SafeFileHandle

Das Dateihandle.

buffer: Span<Byte>

Ein Bereich im Arbeitsspeicher. Wenn diese Methode zurückgibt, werden die Inhalte dieser Region durch die aus der Datei gelesenen Bytes ersetzt.

fileOffset: Int64

Die Dateiposition, aus der gelesen werden soll.

Gibt zurück

Int32

Die Gesamtanzahl der in den Puffer gelesenen Bytes. Dies kann kleiner als die Anzahl der im Puffer zugeordneten Bytes sein, wenn diese anzahl von Bytes derzeit nicht verfügbar ist, oder null (0), wenn das Ende der Datei erreicht wurde.