IsolatedStorageFileStream.ReadAsync Metoda

Definicja

Przestrzeń nazw:

System.IO.IsolatedStorage

Zestaw:

System.IO.IsolatedStorage.dll

Przeciążenia

ReadAsync(Byte[], Int32, Int32, CancellationToken)	Asynchronicznie kopiuje bajty z bieżącego buforowanego IsolatedStorageFileStream obiektu do tablicy bajtów.
ReadAsync(Memory<Byte>, CancellationToken)	Asynchronicznie kopiuje bajty z bieżącego buforowanego IsolatedStorageFileStream obiektu do zakresu pamięci bajtów.

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

Źródło:

IsolatedStorageFileStream.cs

Asynchronicznie kopiuje bajty z bieżącego buforowanego IsolatedStorageFileStream obiektu do tablicy bajtów.

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)

Parametry

buffer

Byte[]

Bufor do zapisania danych.

offset

Int32

Przesunięcie w buforze, w którym należy rozpocząć zapisywanie.

count

Int32

Maksymalna liczba bajtów do odczytania.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Task<Int32>

Zadanie reprezentujące asynchroniczną operację odczytu. Opakowuje łączną liczbę bajtów odczytanych w obiekcie buffer. Może to być mniejsze niż liczba bajtów żądanych, jeśli wiele bajtów nie jest obecnie dostępnych, lub zero, jeśli koniec strumienia zostanie osiągnięty.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Parametr buffer może być wystąpieniem Buffer klasy lub tablicą jednego z następujących typów: Byte, , Int16Int32Int64CharSByteUInt32UInt64UInt16Singlelub .Double

Jeśli operacja odczytu zakończy się pomyślnie, bieżąca pozycja strumienia jest zaawansowana przez liczbę odczytanych bajtów. Jeśli wystąpi wyjątek, bieżąca pozycja strumienia pozostaje niezmieniona.

Metoda ReadAsync traktuje buffer parametr jako blok bajtów, niezależnie od rzeczywistego typu. Podobnie offset parametry i count są zawsze określane w bajtach. W przypadku buffer parametrów innych niż tablice bajtów oznacza to, że indeks elementu lub liczba elementów muszą być mnożone przez rozmiar elementu w bajtach, aby utworzyć poprawną wartość dla offset lub count.

Metoda ReadAsync zwróci zero tylko wtedy, gdy osiągnięto koniec strumienia. We wszystkich innych przypadkach ReadAsync zawsze odczytuje co najmniej jeden bajt ze strumienia przed zwróceniem. Jeśli żadne dane nie są dostępne z IsolatedStorageFileStream obiektu przy wywołaniu metody ReadAsync, metoda będzie blokować do momentu zwrócenia co najmniej jednego bajtu danych.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Read(Byte[], Int32, Int32)usługę .

ReadAsync(Memory<Byte>, CancellationToken)

Źródło:

IsolatedStorageFileStream.cs

Asynchronicznie kopiuje bajty z bieżącego buforowanego IsolatedStorageFileStream obiektu do zakresu pamięci bajtów.

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)

Parametry

buffer

Memory<Byte>

Bufor do zapisania danych.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

ValueTask<Int32>

Zadanie reprezentujące asynchroniczną operację odczytu. Opakowuje łączną liczbę bajtów odczytanych w obiekcie buffer. Może to być mniejsze niż liczba bajtów żądanych, jeśli wiele bajtów nie jest obecnie dostępnych, lub zero, jeśli koniec strumienia zostanie osiągnięty.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.