SslStream.ReadAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| ReadAsync(Memory<Byte>, CancellationToken) |
Асинхронно считывает данные из этого потока и сохраняет их в указанном диапазоне памяти. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Асинхронно считывает данные из этого потока и сохраняет его в указанном диапазоне массива байтов. |
ReadAsync(Memory<Byte>, CancellationToken)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.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)Параметры
- cancellationToken
- CancellationToken
Маркер для отслеживания запросов на отмену.
Возвращаемое значение
Задача, представляющая асинхронную операцию чтения. Значение свойства Result содержит общее количество байтов, считываемых в buffer. Если больше нет данных для чтения, возвращается значение 0.
Исключения
Проверка подлинности не произошла.
Сбой операции чтения. Проверьте внутреннее исключение, если оно присутствует, чтобы определить причину сбоя.
Операция чтения уже выполняется.
Этот объект был закрыт.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Этот метод считывает столько данных, сколько доступно в buffer.
Невозможно выполнить несколько одновременных операций чтения.
Этот метод нельзя вызвать, пока не будет успешно выполнена проверка подлинности.
Применяется к
ReadAsync(Byte[], Int32, Int32, CancellationToken)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.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)Параметры
- buffer
- Byte[]
Буфер, получающий байты, считываемые из этого потока.
- offset
- Int32
Отсчитываемый от нуля расположение, с buffer которого начинается хранение данных из этого потока.
- count
- Int32
Максимальное число байтов для чтения из этого потока.
- cancellationToken
- CancellationToken
Маркер для отслеживания запросов на отмену.
Возвращаемое значение
Задача, представляющая асинхронную операцию чтения. Значение свойства Result содержит общее количество байтов, считываемых в buffer. Если больше нет данных для чтения, возвращается значение 0.
Исключения
buffer равно null.
offset меньше 0.
–или–
count меньше 0.
–или–
count больше длины buffer минуса offset.
Проверка подлинности не произошла.
Сбой операции чтения. Проверьте внутреннее исключение, если оно присутствует, чтобы определить причину сбоя.
Операция чтения уже выполняется.
Этот объект был закрыт.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Метод считывает максимум count байтов из потока и сохраняет их в buffer начале offset.
Невозможно выполнить несколько одновременных операций чтения.
Этот метод нельзя вызвать, пока не будет успешно выполнена проверка подлинности.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Read(Byte[], Int32, Int32).
