NegotiateStream.ReadAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Security

Zestaw:

System.Net.Security.dll

Przeciążenia

ReadAsync(Memory<Byte>, CancellationToken)	Odczytuje dane asynchronicznie z obiektu NegotiateStream i przechowuje je w zakresie pamięci bajtów jako operację asynchroniczną.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Odczytuje dane asynchronicznie z tego strumienia i przechowuje je w określonej tablicy.

ReadAsync(Memory<Byte>, CancellationToken)

Źródło:

NegotiateStream.cs

Odczytuje dane asynchronicznie z obiektu NegotiateStream i przechowuje je w zakresie pamięci bajtów jako operację asynchroniczną.

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

buffer

Memory<Byte>

Bufor do zapisania danych.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

ValueTask<Int32>

Element ValueTask<TResult> reprezentujący operację odczytu asynchronicznego. Wartość jej Result właściwości zawiera całkowitą liczbę bajtów odczytanych do bufferelementu .

Wyjątki

IOException

Operacja odczytu nie powiodła się.

InvalidOperationException

Uwierzytelnianie nie wystąpiło.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta metoda odczytuje asynchronicznie tyle danych, ile jest dostępnych do buffer i zwraca liczbę bajtów, które zostały pomyślnie odczytane.

Nie można wywołać tej metody do momentu pomyślnego uwierzytelnienia. Aby przeprowadzić uwierzytelnianie, wywołaj jedną z AuthenticateAsClientmetod , , AuthenticateAsClientAsyncAuthenticateAsServerBeginAuthenticateAsClient, AuthenticateAsServerAsynclub .BeginAuthenticateAsServer

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

Źródło:

NegotiateStream.cs

Odczytuje dane asynchronicznie z tego strumienia i przechowuje je w określonej tablicy.

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

buffer

Byte[]

Tablica Byte , która odbiera bajty odczytane ze strumienia.

offset

Int32

Lokalizacja Int32 zawierająca lokalizację opartą na zera, w buffer której ma rozpocząć przechowywanie danych odczytanych ze strumienia.

count

Int32

Wartość Int32 zawierająca maksymalną liczbę bajtów do odczytu ze strumienia.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

Task<Int32>

Wartość Int32 określająca liczbę bajtów odczytanych ze strumienia bazowego. Jeśli nie ma więcej danych do odczytu, zwraca wartość 0.

Wyjątki

IOException

Operacja odczytu nie powiodła się.

InvalidOperationException

Uwierzytelnianie nie wystąpiło.

NotSupportedException

Read(Byte[], Int32, Int32) Operacja jest już w toku.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Metoda odczytuje asynchronicznie maksymalnie bajty count z bieżącego strumienia i przechowuje je na buffer początku na offset.

Nie można wywołać tej metody do momentu pomyślnego uwierzytelnienia. Aby przeprowadzić uwierzytelnianie, wywołaj jedną z AuthenticateAsClientmetod , , AuthenticateAsClientAsyncAuthenticateAsServerBeginAuthenticateAsClient, AuthenticateAsServerAsynclub .BeginAuthenticateAsServer

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. 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 Read(Byte[], Int32, Int32)usługę .