ZLibStream.CopyToAsync(Stream, Int32, CancellationToken) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Asynchronně čte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti a tokenu zrušení.
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.
- cancellationToken
- CancellationToken
Token, který se má monitorovat pro žádosti o zrušení.
Návraty
Úloha, která představuje asynchronní operaci kopírování.
Výjimky
destination
je null
.
bufferSize
není kladné číslo.
Datový proud nepodporuje čtení ani zápis.
Datový proud se zavře.
Najednou je povolen pouze jeden asynchronní čtenář nebo zapisovač.
Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.
Poznámky
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).