Поделиться через


NegotiateStream.ReadAsync Метод

Определение

Перегрузки

ReadAsync(Memory<Byte>, CancellationToken)

Асинхронно считывает данные из NegotiateStream и сохраняет их в диапазоне байтов памяти в качестве асинхронной операции.

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

Асинхронно считывает данные из этого потока и сохраняет их в заданном массиве.

ReadAsync(Memory<Byte>, CancellationToken)

Исходный код:
NegotiateStream.cs
Исходный код:
NegotiateStream.cs
Исходный код:
NegotiateStream.cs

Асинхронно считывает данные из NegotiateStream и сохраняет их в диапазоне байтов памяти в качестве асинхронной операции.

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

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

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

Задача ValueTask<TResult>, представляющая асинхронную операцию чтения. Значение свойства Result содержит общее число байтов, считанных в buffer.

Исключения

Сбой операции чтения.

Проверка подлинности не выполнялась.

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

Комментарии

Этот метод асинхронно считывает в buffer и возвращает количество успешно прочитанных байтов.

Вы не сможете вызвать этот метод, пока не пройдете проверку подлинности. Для проверки подлинности AuthenticateAsClientвызовите один из методов , AuthenticateAsClientAsync, BeginAuthenticateAsClientAuthenticateAsServer, , AuthenticateAsServerAsyncили BeginAuthenticateAsServer .

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

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

Исходный код:
NegotiateStream.cs
Исходный код:
NegotiateStream.cs
Исходный код:
NegotiateStream.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[]

Массив элементов Byte, куда помещаются байты, считанные из потока.

offset
Int32

Значение Int32, содержащее расположение (начиная с нуля) в массиве buffer, с которого следует начинать сохранение данных, считанных их этого потока.

count
Int32

Значение Int32, содержащее максимальное количество байтов, которое требуется считать из потока.

cancellationToken
CancellationToken

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

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

Значение Int32, указывающее количество байтов, считанное из базового потока. Когда данных для чтения не остается, возвращает 0.

Исключения

Сбой операции чтения.

Проверка подлинности не выполнялась.

Операция Read(Byte[], Int32, Int32) уже выполняется в настоящее время.

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

Комментарии

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

Вы не сможете вызвать этот метод, пока не пройдете проверку подлинности. Для проверки подлинности AuthenticateAsClientвызовите один из методов , AuthenticateAsClientAsync, BeginAuthenticateAsClientAuthenticateAsServer, , AuthenticateAsServerAsyncили BeginAuthenticateAsServer .

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

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