IsolatedStorageFileStream.ReadAsync Metodo

Definizione

Spazio dei nomi:

System.IO.IsolatedStorage

Assembly:

System.IO.IsolatedStorage.dll

Overload

ReadAsync(Byte[], Int32, Int32, CancellationToken)	Copia in modo asincrono i byte dall'oggetto IsolatedStorageFileStream attualmente memorizzato nel buffer in una matrice di byte.
ReadAsync(Memory<Byte>, CancellationToken)	Copia in modo asincrono i byte dall'oggetto IsolatedStorageFileStream attualmente memorizzato nel buffer in un intervallo di memoria in byte.

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

Origine:

IsolatedStorageFileStream.cs

Copia in modo asincrono i byte dall'oggetto IsolatedStorageFileStream attualmente memorizzato nel buffer in una matrice di byte.

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)

Parametri

buffer

Byte[]

Buffer in cui scrivere i dati.

offset

Int32

Offset nel buffer in corrispondenza del quale iniziare la scrittura.

count

Int32

Numero massimo di byte da leggere.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task<Int32>

Attività che rappresenta l'operazione di lettura asincrona. Esegue il wrapping del numero totale di byte letti nel buffer. Questo numero può essere minore di quello dei byte richiesti, se la quantità di byte non è attualmente disponibile, oppure corrispondere a zero se viene raggiunta la fine del flusso.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Il buffer parametro può essere un'istanza della Buffer classe o una matrice di uno dei tipi seguenti: Byte, , Int16Int32Int64CharSByteUInt32UInt64UInt16Singleo .Double

Se l'operazione di lettura ha esito positivo, la posizione corrente del flusso viene avanzata dal numero di byte letti. Se si verifica un'eccezione, la posizione corrente del flusso rimane invariata.

Il ReadAsync metodo considera il buffer parametro come blocco di byte, indipendentemente dal tipo effettivo. Analogamente, i offset parametri e count vengono sempre specificati in byte. Per buffer i parametri diversi dalle matrici di byte, ciò significa che un indice di elemento o il numero di elementi deve essere moltiplicato per la dimensione dell'elemento in byte per formare un valore corretto per offset o count.

Il ReadAsync metodo restituirà zero solo se viene raggiunta la fine del flusso. In tutti gli altri casi, ReadAsync legge sempre almeno un byte dal flusso prima di restituire . Se non sono disponibili dati dall'oggetto IsolatedStorageFileStream su una chiamata a ReadAsync, il metodo verrà bloccato fino a quando non sarà possibile restituire almeno un byte di dati.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Read(Byte[], Int32, Int32).

ReadAsync(Memory<Byte>, CancellationToken)

Origine:

IsolatedStorageFileStream.cs

Copia in modo asincrono i byte dall'oggetto IsolatedStorageFileStream attualmente memorizzato nel buffer in un intervallo di memoria in byte.

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)

Parametri

buffer

Memory<Byte>

Buffer in cui scrivere i dati.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

ValueTask<Int32>

Attività che rappresenta l'operazione di lettura asincrona. Esegue il wrapping del numero totale di byte letti nel buffer. Questo numero può essere minore di quello dei byte richiesti, se la quantità di byte non è attualmente disponibile, oppure corrispondere a zero se viene raggiunta la fine del flusso.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.