MemoryStream.CopyToAsync(Stream, Int32, CancellationToken) Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

MemoryStream.cs

Asynchronně čte všechny 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 pro monitorování žádostí o zrušení.

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.

OperationCanceledException

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

Poznámky

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