MemoryStream.CopyToAsync(Stream, Int32, CancellationToken) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.IO

Zestaw:: System.IO.dll

Zestaw:: System.Runtime.dll

Zestaw:: System.Runtime.Extensions.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Źródło:: MemoryStream.cs

Źródło:: MemoryStream.cs

Źródło:: MemoryStream.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Asynchronicznie odczytuje wszystkie bajty z bieżącego strumienia i zapisuje je w innym strumieniu przy użyciu określonego rozmiaru buforu i tokenu anulowania.

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

Strumień, do którego zostanie skopiowana zawartość bieżącego strumienia.

bufferSize: Int32

Rozmiar buforu w bajtach. Ta wartość musi być większa niż zero.

cancellationToken: CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

Task

Zadanie reprezentujące operację kopiowania asynchronicznego.

Wyjątki

ArgumentNullException

destination to null.

ArgumentOutOfRangeException

buffersize jest ujemna lub zero.

ObjectDisposedException

Bieżący strumień lub strumień docelowy jest usuwany.

NotSupportedException

Bieżący strumień nie obsługuje odczytu lub strumień docelowy nie obsługuje zapisu.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez CopyTo(Stream, Int32)usługę .

Dotyczy