Sdílet prostřednictvím


MemoryStream.CopyToAsync(Stream, Int32, CancellationToken) Metoda

Definice

Asynchronně přečte všechny bajty z aktuálního datového proudu a zapíše 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 je záporná nebo nulová.

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

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

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

Platí pro