IsolatedStorageFileStream.ReadAsync Metoda

Źródło:

IsolatedStorageFileStream.cs

Źródło:

IsolatedStorageFileStream.cs

Źródło:

IsolatedStorageFileStream.cs

Źródło:

IsolatedStorageFileStream.cs

Źródło:

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)

Parametry

Zwraca

Zadanie reprezentujące operację odczytu asynchronicznego. Opakowuje całkowitą liczbę bajtów odczytanych w obiekcie buffer. Może to być mniej niż liczba bajtów żądanych, jeśli liczba bajtów nie jest obecnie dostępna lub zero, jeśli osiągnięto koniec strumienia.

Wyjątki

Uwagi

Parametr buffer może być wystąpieniem Buffer klasy lub tablicą jednego z następujących typów: Byte, SByteCharInt16Int32Int64UInt16UInt32UInt64Singlelub .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żące położenie strumienia pozostaje niezmienione.

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.

ReadAsync Metoda 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 ReadAsyncmetody , metoda zablokuje co najmniej jeden bajt danych.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program Read(Byte[], Int32, Int32).

Źródło:

IsolatedStorageFileStream.cs

Źródło:

IsolatedStorageFileStream.cs

Źródło:

IsolatedStorageFileStream.cs

Źródło:

IsolatedStorageFileStream.cs

Źródło:

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)

Parametry

Zwraca

Zadanie reprezentujące operację odczytu asynchronicznego. Opakowuje całkowitą liczbę bajtów odczytanych w obiekcie buffer. Może to być mniej niż liczba bajtów żądanych, jeśli liczba bajtów nie jest obecnie dostępna lub zero, jeśli osiągnięto koniec strumienia.

Wyjątki