RandomAccess.Read Méthode

Référence

Définition

Espace de noms:: System.IO

Assembly:: System.Runtime.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Int64

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

ArgumentNullException

handle ou buffers est null.

ArgumentException

handle n'est pas valide.

ObjectDisposedException

Le fichier est fermé.

NotSupportedException

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

ArgumentOutOfRangeException

fileOffset est un nombre négatif.

UnauthorizedAccessException

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

IOException

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

Int32

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.