RandomAccess.ReadAsync 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

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

ValueTask<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 n’est pas disponible actuellement, 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.

OperationCanceledException

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

ValueTask<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 actuellement pas disponibles, ou zéro (0) si la fin du fichier a été atteinte.