Udostępnij za pośrednictwem


SslStream.ReadAsync Metoda

Definicja

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
Źródło:
SslStream.cs
Ź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

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

Uwierzytelnianie nie wystąpiło.

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

Trwa już operacja odczytu.

Ten obiekt został zamknięty.

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.

Dotyczy

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

Źródło:
SslStream.cs
Źródło:
SslStream.cs
Ź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

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

buffer to null.

offset wartość jest mniejsza niż 0.

-lub-

count wartość jest mniejsza niż 0.

-lub-

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

Uwierzytelnianie nie wystąpiło.

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

Trwa już operacja odczytu.

Ten obiekt został zamknięty.

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

Dotyczy