RandomAccess.Read Méthode
Définition
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
| Nom | Description |
|---|---|
| Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64) |
Lit une séquence d’octets à partir d’un fichier donné au décalage donné. |
| Read(SafeFileHandle, Span<Byte>, Int64) |
Lit une séquence d’octets à partir d’un fichier donné au décalage donné. |
Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
Lit une séquence d’octets à partir d’un fichier donné au 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 -> int64Public Shared Function Read (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long) As LongParamètres
- handle
- SafeFileHandle
Handle de fichier.
- buffers
- IReadOnlyList<Memory<Byte>>
Liste des mémoires tampons de mémoire. 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 du fichier à lire. Dans .NET versions 11 et ultérieures, ce paramètre est ignoré pour les fichiers qui ne prennent pas en charge la recherche, tels que les canaux, les sockets et les périphériques de caractères. La valeur doit être non négative même lorsqu’elle est ignorée.
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 n’est pas actuellement disponible, 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é.
Dans .NET versions 10 et antérieures, le fichier ne prend pas en charge la recherche (par exemple, un canal ou un socket).
fileOffset est négatif.
handle n’a pas été ouvert pour lecture.
Une erreur d’E/S s’est produite.
Remarques
Pour les fichiers qui prennent en charge la recherche, 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
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
Lit une séquence d’octets à partir d’un fichier donné au 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 -> intPublic Shared Function Read (handle As SafeFileHandle, buffer As Span(Of Byte), fileOffset As Long) As IntegerParamètres
- handle
- SafeFileHandle
Handle de fichier.
Une région de 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 du fichier à lire. Dans .NET versions 11 et ultérieures, ce paramètre est ignoré pour les fichiers qui ne prennent pas en charge la recherche, tels que les canaux, les sockets et les périphériques de caractères. La valeur doit être non négative même lorsqu’elle est ignorée.
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é.
Dans .NET versions 10 et antérieures, le fichier ne prend pas en charge la recherche (par exemple, un canal ou un socket).
fileOffset est négatif.
handle n’a pas été ouvert pour lecture.
Une erreur d’E/S s’est produite.
Remarques
Pour les fichiers qui prennent en charge la recherche, la position du fichier n’est pas avancée.
