Stream.ReadExactlyAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Asynchronně čte bajty z aktuálního datového proudu, posune pozici v rámci datového proudu, dokud buffer se nenaplní, a monitoruje žádosti o zrušení.
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Asynchronně čte count počet bajtů z aktuálního datového proudu, posune pozici v rámci datového proudu a monitoruje požadavky na zrušení.

ReadExactlyAsync(Memory<Byte>, CancellationToken)

Zdroj:

Stream.cs

Asynchronně čte bajty z aktuálního datového proudu, posune pozici v rámci datového proudu, dokud buffer se nenaplní, a monitoruje žádosti o zrušení.

public System.Threading.Tasks.ValueTask ReadExactlyAsync(Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

member this.ReadExactlyAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ReadExactlyAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametry

buffer

Memory<Byte>

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

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení.

Návraty

ValueTask

Úloha, která představuje asynchronní operaci čtení.

Výjimky

EndOfStreamException

Konec toku je dosaženo před vyplněním buffer.

OperationCanceledException

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

Poznámky

Pokud buffer je tato operace čtení prázdná, dokončí se bez čekání na dostupná data ve streamu.

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

Zdroj:

Stream.cs

Asynchronně čte count počet bajtů z aktuálního datového proudu, posune pozici v rámci datového proudu a monitoruje požadavky na zrušení.

public System.Threading.Tasks.ValueTask ReadExactlyAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken = default);

member this.ReadExactlyAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ReadExactlyAsync (buffer As Byte(), offset As Integer, count As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametry

buffer

Byte[]

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

offset

Int32

Posun bajtů, při buffer kterém se mají začít zapisovat data z datového proudu.

count

Int32

Počet bajtů, které se mají číst z aktuálního datového proudu.

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení.

Návraty

ValueTask

Úloha, která představuje asynchronní operaci čtení.

Výjimky

ArgumentNullException

buffer je null.

ArgumentOutOfRangeException

offset je mimo hranice buffer.

nebo

count je negativní.

nebo

Rozsah určený kombinací offset a count překračuje délku buffer.

EndOfStreamException

Konec datového proudu se dosáhne před načtením count počtu bajtů.

OperationCanceledException

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

Poznámky

Pokud count je hodnota 0 (nula), bude tato operace čtení dokončena bez čekání na dostupná data ve streamu.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ReadExactly(Byte[], Int32, Int32).