Partager via


RandomAccess.ReadAsync Méthode

Définition

Surcharges

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)

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

ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)

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

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)

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 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. Lorsque cette méthode retourne, le contenu de ces mémoires tampons est remplacé par les octets lus à partir du fichier.

fileOffset
Int64

Position de fichier à partir de laquelle lire.

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes 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 n’est pas disponible actuellement, 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.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

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

Cette méthode stocke dans la tâche toutes les exceptions de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître 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

Lit une séquence d’octets d’un fichier donné à un 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.

buffer
Memory<Byte>

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

fileOffset
Int64

Position de fichier à partir de laquelle lire.

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes 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 actuellement pas 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.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

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

S’applique à