IsolatedStorageFileStream.ReadAsync Метод

Определение

Пространство имен:

System.IO.IsolatedStorage

Сборка:

System.IO.IsolatedStorage.dll

Перегрузки

ReadAsync(Byte[], Int32, Int32, CancellationToken)	Асинхронно копирует байты из текущего буферизованного объекта IsolatedStorageFileStream в диапазон массив байтов.
ReadAsync(Memory<Byte>, CancellationToken)	Асинхронно копирует байты из текущего буферизованного объекта IsolatedStorageFileStream в диапазон памяти байтов.

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

Исходный код:

IsolatedStorageFileStream.cs

Асинхронно копирует байты из текущего буферизованного объекта IsolatedStorageFileStream в диапазон массив байтов.

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)

Параметры

buffer

Byte[]

Буфер, в который записываются данные.

offset

Int32

Смещение в буфере, с которого начинается запись.

count

Int32

Максимальное число байтов, предназначенных для чтения.

cancellationToken

CancellationToken

Токен для отслеживания запросов отмены. Значение по умолчанию — None.

Возвращаемое значение

Task<Int32>

Задача, представляющая асинхронную операцию чтения. Заключает общее число байтов, считанных в buffer. Это число может быть меньше запрошенного числа байтов, если многие байты недоступны в данный момент, или равно нулю, если достигнут конец потока.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Параметр buffer может быть экземпляром Buffer класса или массивом одного из следующих типов: Byte, SByte, Char, Int16, Int32, , Int64, UInt16, UInt32, UInt64, , Singleили Double.

Если операция чтения выполнена успешно, текущая позиция потока будет расширена на количество прочитанных байтов. Если возникает исключение, текущая позиция потока не изменяется.

Метод ReadAsync обрабатывает buffer параметр как блок байтов, независимо от его фактического типа. Аналогичным образом параметры offset и count всегда указываются в байтах. Для buffer параметров, отличных от массивов байтов, это означает, что индекс элемента или количество элементов должны умножаться на размер элемента в байтах, чтобы сформировать правильное значение для offset или count.

Метод ReadAsync возвращает ноль, только если достигнут конец потока. Во всех остальных случаях ReadAsync всегда считывает по крайней мере один байт из потока перед возвратом. Если данные из IsolatedStorageFileStream объекта не доступны при вызове ReadAsyncметода , метод блокируется до тех пор, пока не будет возвращен хотя бы один байт данных.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Read(Byte[], Int32, Int32).

ReadAsync(Memory<Byte>, CancellationToken)

Исходный код:

IsolatedStorageFileStream.cs

Асинхронно копирует байты из текущего буферизованного объекта IsolatedStorageFileStream в диапазон памяти байтов.

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)

Параметры

buffer

Memory<Byte>

Буфер, в который записываются данные.

cancellationToken

CancellationToken

Токен для отслеживания запросов отмены. Значение по умолчанию — None.

Возвращаемое значение

ValueTask<Int32>

Задача, представляющая асинхронную операцию чтения. Заключает общее число байтов, считанных в buffer. Это число может быть меньше запрошенного числа байтов, если многие байты недоступны в данный момент, или равно нулю, если достигнут конец потока.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.