CryptoStream.ReadAsync Metoda

Definice

Obor názvů:

System.Security.Cryptography

Sestavení:

netstandard.dll, System.Security.Cryptography.dll

Přetížení

Name	Description
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Přečte posloupnost bajtů z aktuálního datového proudu asynchronně, posune pozici v datovém proudu o počet přečtených bajtů a monitoruje žádosti o zrušení.
ReadAsync(Memory<Byte>, CancellationToken)	Asynchronně přečte posloupnost bajtů z aktuálního datového proudu, posune pozici v datovém proudu o počet přečtených bajtů a monitoruje žádosti o zrušení.

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

Zdroj:

CryptoStream.cs

Přečte posloupnost bajtů z aktuálního datového proudu asynchronně, posune pozici v datovém proudu o počet přečtených bajtů a monitoruje žádosti o 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 do.

offset

Int32

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

count

Int32

Maximální počet bajtů, které se mají přečíst.

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení. Výchozí hodnota je None.

Návraty

Task<Int32>

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

Výjimky

ArgumentNullException

buffer je null.

ArgumentOutOfRangeException

offset nebo count je negativní.

ArgumentException

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

NotSupportedException

Stream nepodporuje čtení.

ObjectDisposedException

Stream byl odstraněn.

InvalidOperationException

Stream se aktuálně používá předchozí operací čtení.

OperationCanceledException

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

Poznámky

Důležité

Od verze .NET 6 nemusí tato metoda číst tolik bajtů, kolik bylo požadováno. Další informace naleznete v tématu Částečné a nulové bajty čtení v DeflateStream, GZipStream a CryptoStream.

Před voláním ReadAsync operátoru await (C#) nebo Await (Visual Basic) je nutné pozastavit provádění metody, dokud nebude úkol dokončen. Další informace naleznete v tématu Asynchronní programování (C#) nebo Asynchronní programování pomocí Async a Await (Visual Basic).

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

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é Read(Byte[], Int32, Int32).

Viz také

• Zrušení ve spravovaných vláknech

ReadAsync(Memory<Byte>, CancellationToken)

Zdroj:

CryptoStream.cs

Asynchronně přečte posloupnost bajtů z aktuálního datového proudu, posune pozici v datovém proudu o počet přečtených bajtů a monitoruje žádosti o 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 do.

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení. Výchozí hodnota je None.

Návraty

ValueTask<Int32>

Úloha, která představuje asynchronní operaci čtení. Hodnota jeho Result vlastnosti obsahuje celkový počet bajtů přeč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 není aktuálně k dispozici mnoho bajtů, nebo může být 0 (nula), pokud bylo dosaženo konce datového proudu.

Výjimky

NotSupportedException

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

OperationCanceledException

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

Poznámky

Od verze .NET 6 nemusí tato metoda číst tolik bajtů, kolik bylo požadováno. Další informace naleznete v tématu Částečné a nulové bajty čtení v DeflateStream, GZipStream a CryptoStream.