NetworkStream.ReadAsync Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

Přetížení

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

ReadAsync(Memory<Byte>, CancellationToken)

Zdroj:

NetworkStream.cs

Čte data z objektu NetworkStream 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

InvalidOperationException

Nepodporuje NetworkStream čtení.

IOException

Při přístupu k soketu došlo k chybě.

-nebo-

Při čtení ze sítě došlo k chybě.

ObjectDisposedException

Je NetworkStream zavřený.

OperationCanceledException

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

Poznámky

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

Poznámka

Zkontrolujte, jestli NetworkStream je čitelný voláním CanRead vlastnosti . Pokud se pokusíte číst z objektu NetworkStream , který není čitelný, zobrazí se InvalidOperationException.

Poznámka

Pokud obdržíte IOException, zkontrolujte vlastnost a InnerException zjistěte, jestli nebyla způsobená SocketException. Pokud ano, použijte ErrorCode vlastnost k získání konkrétního kódu chyby a podrobný popis chyby najdete v dokumentaci ke kódu chyb rozhraní API rozhraní Windows Sockets verze 2 .

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

Zdroj:

NetworkStream.cs

Čte data z objektu NetworkStream a ukládá je do zadaného rozsahu pole bajtů jako asynchronní operace.

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

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

offset

Int32

Umístění v, do buffer které se mají data začít ukládat.

count

Int32

Počet bajtů, které se mají přečíst z NetworkStream.

cancellationToken

CancellationToken

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

Návraty

Task<Int32>

Úloha, která představuje asynchronní operaci čtení. Hodnota jeho Result vlastnosti obsahuje celkový počet bajtů načtených do buffer.

Výjimky

InvalidOperationException

Nepodporuje NetworkStream čtení.

IOException

Při přístupu k soketu došlo k chybě.

-nebo-

Při čtení ze sítě došlo k chybě.

ObjectDisposedException

Je NetworkStream zavřený.

OperationCanceledException

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

Poznámky

Tato metoda načte data do buffer a vrátí počet bajtů, které byly úspěšně přečtené. Operace ReadAsync načte tolik dat, kolik je k dispozici, až do počtu bajtů určených parametrem size .

Poznámka

Zkontrolujte, jestli NetworkStream je čitelný voláním CanRead vlastnosti . Pokud se pokusíte číst z objektu NetworkStream , který není čitelný, zobrazí se InvalidOperationException.

Poznámka

Pokud obdržíte IOException, zkontrolujte vlastnost a InnerException zjistěte, jestli nebyla způsobená SocketException. Pokud ano, použijte ErrorCode vlastnost k získání konkrétního kódu chyby a podrobný popis chyby najdete v dokumentaci ke kódu chyb rozhraní API rozhraní Windows Sockets verze 2 .

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