IsolatedStorageFileStream.ReadAsync Méthode

Définition

Espace de noms:

System.IO.IsolatedStorage

Assembly:

System.IO.IsolatedStorage.dll

Surcharges

ReadAsync(Byte[], Int32, Int32, CancellationToken)	Copie de façon asynchrone les octets de l’objet IsolatedStorageFileStream actuel mis en mémoire tampon dans un tableau d’octets.
ReadAsync(Memory<Byte>, CancellationToken)	Copie de façon asynchrone les octets de l’objet IsolatedStorageFileStream actuel mis en mémoire tampon dans une plage de mémoire d’octets.

ReadAsync(Byte[], Int32, Int32, CancellationToken)

Source:

IsolatedStorageFileStream.cs

Copie de façon asynchrone les octets de l’objet IsolatedStorageFileStream actuel mis en mémoire tampon dans un tableau d’octets.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

Paramètres

buffer

Byte[]

Mémoire tampon où écrire les données.

offset

Int32

Dans la mémoire tampon, décalage auquel commencer l'écriture.

count

Int32

Nombre maximal d'octets à lire.

cancellationToken

CancellationToken

Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est None.

Retours

Task<Int32>

Tâche qui représente l'opération de lecture asynchrone. Elle encapsule le nombre total d’octets lus dans buffer. Ce nombre peut être inférieur au nombre d'octets demandé si un tel nombre d'octets n'est pas actuellement disponible, ou il peut être égal à zéro si la fin du flux est atteinte.

Exceptions

OperationCanceledException

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

Remarques

Le buffer paramètre peut être un instance de la Buffer classe ou un tableau de l’un des types suivants : Byte, , Int32Int16Int64SByteCharUInt16, UInt32, UInt64, Singleou .Double

Si l’opération de lecture réussit, la position actuelle du flux est avancée par le nombre d’octets lus. Si une exception se produit, la position actuelle du flux est inchangée.

La ReadAsync méthode traite le buffer paramètre comme un bloc d’octets, quel que soit son type réel. De même, les offset paramètres et count sont toujours spécifiés en octets. Pour buffer les paramètres autres que les tableaux d’octets, cela signifie qu’un index d’élément ou le nombre d’éléments doivent être multipliés par la taille de l’élément en octets pour former une valeur correcte pour offset ou count.

La ReadAsync méthode retourne zéro uniquement si la fin du flux est atteinte. Dans tous les autres cas, ReadAsync lit toujours au moins un octet du flux avant de retourner. Si aucune donnée n’est disponible à partir de l’objet IsolatedStorageFileStream lors d’un appel à ReadAsync, la méthode se bloque jusqu’à ce qu’au moins un octet de données puisse être retourné.

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(Byte[], Int32, Int32).

ReadAsync(Memory<Byte>, CancellationToken)

Source:

IsolatedStorageFileStream.cs

Copie de façon asynchrone les octets de l’objet IsolatedStorageFileStream actuel mis en mémoire tampon dans une plage de mémoire d’octets.

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Paramètres

buffer

Memory<Byte>

Mémoire tampon où écrire les données.

cancellationToken

CancellationToken

Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est None.

Retours

ValueTask<Int32>

Tâche qui représente l'opération de lecture asynchrone. Elle encapsule le nombre total d’octets lus dans buffer. Ce nombre peut être inférieur au nombre d'octets demandé si un tel nombre d'octets n'est pas actuellement disponible, ou il peut être égal à zéro si la fin du flux est atteinte.

Exceptions

OperationCanceledException

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