CryptoStream.CopyToAsync(Stream, Int32, CancellationToken) Metoda

Definice

Obor názvů:

System.Security.Cryptography

Sestavení:

System.Security.Cryptography.dll

Zdroj:

CryptoStream.cs

Asynchronně přečte bajty z podkladového datového proudu, použije příslušné kryptografické transformace a zapíše výsledek do cílového datového proudu.

public:
 override System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, int bufferSize, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task CopyToAsync (System.IO.Stream destination, int bufferSize, System.Threading.CancellationToken cancellationToken);

override this.CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function CopyToAsync (destination As Stream, bufferSize As Integer, cancellationToken As CancellationToken) As Task

Parametry

destination

Stream

Datový proud, do kterého se zkopíruje obsah aktuálního datového proudu.

bufferSize

Int32

Velikost vyrovnávací paměti (v bajtech). Tato hodnota musí být větší než nula. Výchozí velikost je 81920.

cancellationToken

CancellationToken

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

Návraty

Task

Úloha, která představuje asynchronní operaci kopírování.

Výjimky

ArgumentNullException

destination je null.

ArgumentOutOfRangeException

buffersize je záporná nebo nulová.

ObjectDisposedException

Buď aktuální datový proud, nebo cílový datový proud je uvolněn.

NotSupportedException

Aktuální datový proud nepodporuje čtení nebo cílový datový proud nepodporuje zápis.

CryptographicException

Během kryptografické operace došlo k chybě.

OperationCanceledException

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

Poznámky

Kopírování začíná na aktuální pozici v aktuálním datovém proudu a po dokončení operace kopírování neobnoví pozici cílového datového proudu.

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 CopyTo(Stream, Int32).