Udostępnij za pośrednictwem


NegotiateStream.ReadAsync Metoda

Definicja

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
Ź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 zapisania 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 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

Dotyczy

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

Ź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 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

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

Operacja odczytu nie powiodła się.

Uwierzytelnianie nie wystąpiło.

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

Dotyczy