IsolatedStorageFileStream.ReadAsync Méthode

Source:

IsolatedStorageFileStream.cs

Source:

IsolatedStorageFileStream.cs

Source:

IsolatedStorageFileStream.cs

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

Remarques

Le buffer paramètre peut être une instance de la Buffer classe ou un tableau de l’un des types suivants : Byte, , SByte, Int16Int64CharInt32UInt16, 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).

Source:

IsolatedStorageFileStream.cs

Source:

IsolatedStorageFileStream.cs

Source:

IsolatedStorageFileStream.cs

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