Język

NegotiateStream.ReadAsync Metoda

Definicja

Przeciążenia

Nazwa Opis
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
Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs
Ź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 zapisu danych.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

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

Operacja odczytu nie powiodła się.

Uwierzytelnianie nie wystąpiło.

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta metoda odczytuje asynchronicznie tyle danych, ile jest dostępnych do buffer i zwraca liczbę bajtów pomyślnie odczytanych.

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

Dotyczy

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

Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs
Ź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 zerach, w buffer której należy rozpocząć przechowywanie danych odczytanych ze strumienia.

count
Int32

Element Int32 zawierający maksymalną liczbę bajtów do odczytu ze strumienia.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

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

Wyjątki

Operacja odczytu nie powiodła się.

Uwierzytelnianie nie wystąpiło.

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

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

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

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program Read(Byte[], Int32, Int32).

Dotyczy