SslStream.ReadAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Security

Zestaw:

System.Net.Security.dll

Przeciążenia

ReadAsync(Memory<Byte>, CancellationToken)	Asynchronicznie odczytuje dane z tego strumienia i przechowuje je w określonym zakresie pamięci.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Asynchronicznie odczytuje dane z tego strumienia i przechowuje je w określonym zakresie tablicy bajtów.

ReadAsync(Memory<Byte>, CancellationToken)

Źródło:

SslStream.cs

Asynchronicznie odczytuje dane z tego strumienia i przechowuje je w określonym zakresie pamięci.

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 odbierający bajty odczytane z tego strumienia.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

ValueTask<Int32>

Zadanie reprezentujące operację odczytu asynchronicznego. Wartość jej Result właściwości zawiera całkowitą liczbę bajtów odczytanych do bufferelementu . Jeśli nie ma więcej danych do odczytu, zwraca wartość 0.

Wyjątki

InvalidOperationException

Uwierzytelnianie nie wystąpiło.

IOException

Operacja odczytu nie powiodła się. Sprawdź wyjątek wewnętrzny, jeśli jest obecny, aby określić przyczynę awarii.

NotSupportedException

Trwa już operacja odczytu.

ObjectDisposedException

Ten obiekt został zamknięty.

OperationCanceledException

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

Uwagi

Ta metoda odczytuje tyle danych, ile jest dostępnych w obiekcie buffer.

Nie można wykonywać wielu równoczesnych operacji odczytu.

Nie można wywołać tej metody do momentu pomyślnego uwierzytelnienia.

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

Źródło:

SslStream.cs

Asynchronicznie odczytuje dane z tego strumienia i przechowuje je w określonym zakresie tablicy bajtów.

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[]

Bufor odbierający bajty odczytane z tego strumienia.

offset

Int32

Lokalizacja oparta na zera, w buffer której ma rozpocząć przechowywanie danych odczytanych ze strumienia.

count

Int32

Maksymalna liczba bajtów do odczytu z tego strumienia.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

Task<Int32>

Zadanie reprezentujące operację odczytu asynchronicznego. Wartość jej Result właściwości zawiera całkowitą liczbę bajtów odczytanych do bufferelementu . Jeśli nie ma więcej danych do odczytu, zwraca wartość 0.

Wyjątki

ArgumentNullException

buffer to null.

ArgumentOutOfRangeException

offset wartość jest mniejsza niż 0.

-lub-

count wartość jest mniejsza niż 0.

-lub-

count jest większa niż długość buffer minus offset.

InvalidOperationException

Uwierzytelnianie nie wystąpiło.

IOException

Operacja odczytu nie powiodła się. Sprawdź wyjątek wewnętrzny, jeśli jest obecny, aby określić przyczynę awarii.

NotSupportedException

Trwa już operacja odczytu.

ObjectDisposedException

Ten obiekt został zamknięty.

OperationCanceledException

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

Uwagi

Metoda odczytuje maksymalnie bajty count ze strumienia i przechowuje je na buffer początku na .offset

Nie można wykonywać wielu równoczesnych operacji odczytu.

Nie można wywołać tej metody do momentu pomyślnego uwierzytelnienia.

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ę .