IsolatedStorageFileStream.ReadAsync Méthode

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

Retours

Tâche qui représente l’opération de lecture asynchrone. Il encapsule le nombre total d’octets lus dans le buffer. Cela peut être inférieur au nombre d’octets demandé si de nombreux octets ne sont pas actuellement disponibles, ou zéro si la fin du flux est atteinte.

Exceptions

Remarques

Le buffer paramètre peut être une instance de la Buffer classe, ou un tableau d’un des types suivants : Byte, , CharSByte, Int16, , Int32, , Int64, UInt16UInt32, 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 n’est pas modifié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 paramètres et count les offset paramètres 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 doit être multiplié 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 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 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(Byte[], Int32, Int32).

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

Retours

Tâche qui représente l’opération de lecture asynchrone. Il encapsule le nombre total d’octets lus dans le buffer. Cela peut être inférieur au nombre d’octets demandé si de nombreux octets ne sont pas actuellement disponibles, ou zéro si la fin du flux est atteinte.

Exceptions