NegotiateStream.ReadAsync Metoda

Definice

Obor názvů:

System.Net.Security

Sestavení:

System.Net.Security.dll

Přetížení

ReadAsync(Memory<Byte>, CancellationToken)	Čte data asynchronně z objektu NegotiateStream a ukládá je do rozsahu bajtové paměti jako asynchronní operace.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Čte data asynchronně z tohoto streamu a ukládá je do zadaného pole.

ReadAsync(Memory<Byte>, CancellationToken)

Zdroj:

NegotiateStream.cs

Čte data asynchronně z objektu NegotiateStream a ukládá je do rozsahu bajtové paměti jako asynchronní operace.

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>

Vyrovnávací paměť pro zápis dat.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení.

Návraty

ValueTask<Int32>

A ValueTask<TResult> , který představuje asynchronní operaci čtení. Hodnota jeho Result vlastnosti obsahuje celkový počet bajtů načtených do buffer.

Výjimky

IOException

Operace čtení se nezdařila.

InvalidOperationException

K ověření nedošlo.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato metoda čte asynchronně tolik dat, kolik je k dispozici, buffer a vrátí počet bajtů úspěšně přečtených.

Tuto metodu nelze volat, dokud se úspěšně neověříte. Pokud chcete provést ověření, zavolejte jednu z AuthenticateAsClientmetod , AuthenticateAsClientAsync, BeginAuthenticateAsClient, AuthenticateAsServer, AuthenticateAsServerAsyncnebo BeginAuthenticateAsServer .

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

Zdroj:

NegotiateStream.cs

Čte data asynchronně z tohoto streamu a ukládá je do zadaného pole.

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

Pole Byte , které přijímá bajty načtené z datového proudu.

offset

Int32

Obsahující Int32 umístění založené na nule, ve buffer kterém chcete začít ukládat data načtená z tohoto datového proudu.

count

Int32

Obsahující Int32 maximální počet bajtů, které se mají načíst z datového proudu.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení.

Návraty

Task<Int32>

Hodnota Int32 , která určuje počet bajtů přečtených z podkladového datového proudu. Pokud nejsou k dispozici žádná další data ke čtení, vrátí 0.

Výjimky

IOException

Operace čtení se nezdařila.

InvalidOperationException

K ověření nedošlo.

NotSupportedException

Operace Read(Byte[], Int32, Int32) již probíhá.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Metoda načítá asynchronně maximální počet bajtů z aktuálního datového count proudu a ukládá je od offsetbuffer .

Tuto metodu nelze volat, dokud se úspěšně neověříte. Pokud chcete provést ověření, zavolejte jednu z AuthenticateAsClientmetod , AuthenticateAsClientAsync, BeginAuthenticateAsClient, AuthenticateAsServer, AuthenticateAsServerAsyncnebo BeginAuthenticateAsServer .

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Read(Byte[], Int32, Int32).