Stream.ReadExactlyAsync Метод

Определение

Перегрузки

ReadExactlyAsync(Memory<Byte>, CancellationToken)

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

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

Асинхронно считывает count количество байтов из текущего потока, перемещает позицию в потоке и отслеживает запросы на отмену.

ReadExactlyAsync(Memory<Byte>, CancellationToken)

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

public System.Threading.Tasks.ValueTask ReadExactlyAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
member this.ReadExactlyAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function ReadExactlyAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Параметры

buffer
Memory<Byte>

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

cancellationToken
CancellationToken

Токен для отслеживания запросов отмены.

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

ValueTask

Задача, представляющая асинхронную операцию чтения.

Исключения

Конец потока достигается перед заполнением buffer.

Комментарии

Если buffer она пуста, эта операция чтения будет завершена без ожидания доступных данных в потоке.

Применяется к

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

Асинхронно считывает count количество байтов из текущего потока, перемещает позицию в потоке и отслеживает запросы на отмену.

public System.Threading.Tasks.ValueTask ReadExactlyAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken = default);
member this.ReadExactlyAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function ReadExactlyAsync (buffer As Byte(), offset As Integer, count As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Параметры

buffer
Byte[]

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

offset
Int32

Смещение байтов в buffer, с которого начинается запись данных из потока.

count
Int32

Число байтов, считываемых из текущего потока.

cancellationToken
CancellationToken

Токен для отслеживания запросов отмены.

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

ValueTask

Задача, представляющая асинхронную операцию чтения.

Исключения

buffer имеет значение null.

Значение параметра offset выходит за пределы массива buffer.

-или-

count является отрицательным значением.

-или-

Диапазон, заданный offset сочетанием и count превышающий длину buffer.

Конец потока достигается до считывания count числа байтов.

Комментарии

Если count значение равно 0 (ноль), эта операция чтения будет завершена без ожидания доступных данных в потоке.

Применяется к