RandomAccess.ReadAsync 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 |
|---|---|
| ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken) |
Lit une séquence d’octets à partir d’un fichier donné au décalage donné. |
| ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken) |
Lit une séquence d’octets à partir d’un fichier donné au décalage donné. |
ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)
- 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 System.Threading.Tasks.ValueTask<long> ReadAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int64>Public Shared Function ReadAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Long)Paramè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 de ces 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.
- cancellationToken
- CancellationToken
Jeton à surveiller pour les demandes d’annulation. La valeur par défaut est None.
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.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
Pour les fichiers qui prennent en charge la recherche, la position du fichier n’est pas avancée.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64).
S’applique à
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)
- 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 System.Threading.Tasks.ValueTask<int> ReadAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, Memory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * Memory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>Public Shared Function ReadAsync (handle As SafeFileHandle, buffer As Memory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)Paramè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.
- cancellationToken
- CancellationToken
Jeton à surveiller pour les demandes d’annulation. La valeur par défaut est None.
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.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
Pour les fichiers qui prennent en charge la recherche, la position du fichier n’est pas avancée.
