Sdílet prostřednictvím


CryptoStream.ReadAsync Metoda

Definice

Přetížení

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

Přečte posloupnost bajtů z aktuálního datového proudu asynchronně, posune pozici v rámci datového proudu o počet přečtených bajtů a sleduje požadavky na zrušení.

ReadAsync(Memory<Byte>, CancellationToken)

Asynchronně přečte sekvenci bajtů z aktuálního datového proudu, posune pozici v rámci datového proudu o počet přečtených bajtů a sleduje požadavky na zrušení.

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

Zdroj:
CryptoStream.cs
Zdroj:
CryptoStream.cs
Zdroj:
CryptoStream.cs

Přečte posloupnost bajtů z aktuálního datového proudu asynchronně, posune pozici v rámci datového proudu o počet přečtených bajtů a sleduje požadavky na zrušení.

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

Posun bajtů, při buffer kterém se mají začít zapisovat data ze streamu.

count
Int32

Maximální počet bajtů ke čtení.

cancellationToken
CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Úloha, která představuje asynchronní operaci čtení. Hodnota parametru objektu TResult úkolu obsahuje celkový počet bajtů načtených do vyrovnávací paměti. Výsledek může být menší než požadovaný počet bajtů, pokud je počet aktuálně dostupných bajtů menší než požadované číslo, nebo může být 0 (nula), pokud bylo dosaženo konce datového proudu.

Výjimky

buffer je null.

offset nebo count je negativní.

Součet offset hodnot a count je větší než délka vyrovnávací paměti.

Datový proud nepodporuje čtení.

Datový proud byl odstraněn.

Datový proud je aktuálně používán předchozí operací čtení.

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

Poznámky

Důležité

Počínaje verzí .NET 6 nemusí tato metoda číst tolik bajtů, kolik bylo požadováno. Další informace naleznete v části Částečné a nulové čtení v DeflateStream, GZipStream a CryptoStream.

Před voláním ReadAsyncawait je nutné zadat operátor (C#) nebo Await (Visual Basic), aby se pozastavila provádění metody až do dokončení úlohy. Další informace najdete v tématu Asynchronní programování (C#) nebo Asynchronní programování pomocí funkcí Async a Await (Visual Basic).

Pokud je operace zrušena před dokončením, bude vrácená úloha obsahovat Canceled hodnotu vlastnosti Status .

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

Viz také

Platí pro

ReadAsync(Memory<Byte>, CancellationToken)

Zdroj:
CryptoStream.cs
Zdroj:
CryptoStream.cs
Zdroj:
CryptoStream.cs

Asynchronně přečte sekvenci bajtů z aktuálního datového proudu, posune pozici v rámci datového proudu o počet přečtených bajtů a sleduje požadavky na zrušení.

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>

Oblast paměti pro zápis dat.

cancellationToken
CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Úloha, která představuje asynchronní operaci čtení. Hodnota vlastnosti Result obsahuje celkový počet bajtů načtených do vyrovnávací paměti. Výsledná hodnota může být menší než počet bajtů přidělených ve vyrovnávací paměti, pokud tento počet bajtů není aktuálně k dispozici, nebo může být 0 (nula), pokud bylo dosaženo konce datového proudu.

Výjimky

Přidružený CryptoStreamMode k aktuálnímu CryptoStream objektu neodpovídá podkladovému datovému proudu. Tato výjimka se například vyvolá při použití Read s podkladovým datovým proudem, který je jen pro zápis.

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

Poznámky

Počínaje verzí .NET 6 nemusí tato metoda číst tolik bajtů, kolik bylo požadováno. Další informace naleznete v části Částečné a nulové čtení v DeflateStream, GZipStream a CryptoStream.

Platí pro