Partager via


RandomAccess.Read Méthode

Définition

Surcharges

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

Lit une séquence d’octets d’un fichier donné à un décalage donné.

Read(SafeFileHandle, Span<Byte>, Int64)

Lit une séquence d’octets d’un fichier donné à un décalage donné.

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

Source:
RandomAccess.cs
Source:
RandomAccess.cs
Source:
RandomAccess.cs

Lit une séquence d’octets d’un fichier donné à un décalage donné.

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

Paramètres

handle
SafeFileHandle

Handle de fichier.

buffers
IReadOnlyList<Memory<Byte>>

Liste des mémoires tampons. Lorsque cette méthode est retournée, le contenu des mémoires tampons est remplacé par les octets lus à partir du fichier.

fileOffset
Int64

Position de fichier à partir de laquelle lire.

Retours

Nombre total d’octets lus dans les mémoires tampons. Cela peut être inférieur au nombre d’octets alloués dans les mémoires tampons si ce nombre d’octets ne sont pas actuellement disponibles, ou zéro (0) si la fin du fichier a été atteinte.

Exceptions

handle ou buffers est null.

handle n'est pas valide.

Le fichier est fermé.

Le fichier ne prend pas en charge la recherche (canal ou socket).

fileOffset est un nombre négatif.

handle n’a pas été ouvert pour lecture.

Une erreur d'E/S s'est produite.

Remarques

La position du fichier n’est pas avancée.

S’applique à

Read(SafeFileHandle, Span<Byte>, Int64)

Source:
RandomAccess.cs
Source:
RandomAccess.cs
Source:
RandomAccess.cs

Lit une séquence d’octets d’un fichier donné à un décalage donné.

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

Paramètres

handle
SafeFileHandle

Handle de fichier.

buffer
Span<Byte>

Région de la mémoire. Lorsque cette méthode est retournée, le contenu de cette région est remplacé par les octets lus à partir du fichier.

fileOffset
Int64

Position de fichier à partir de laquelle lire.

Retours

Nombre total d'octets lus dans la mémoire tampon. Cela peut être inférieur au nombre d’octets alloués dans la mémoire tampon si ce nombre d’octets ne sont pas actuellement disponibles, ou zéro (0) si la fin du fichier a été atteinte.

Exceptions

handle a la valeur null.

handle n'est pas valide.

Le fichier est fermé.

Le fichier ne prend pas en charge la recherche (canal ou socket).

fileOffset est un nombre négatif.

handle n’a pas été ouvert pour lecture.

Une erreur d'E/S s'est produite.

Remarques

La position du fichier n’est pas avancée.

S’applique à