ZLibStream.CopyToAsync(Stream, Int32, CancellationToken) Метод

Определение

Пространство имен:

System.IO.Compression

Сборка:

System.IO.Compression.dll

Исходный код:

ZLibStream.cs

Асинхронно считывает байты из текущего потока и записывает их в другой поток, используя указанный размер буфера и токен отмены.

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

Параметры

destination

Stream

Поток, в который будет скопировано содержимое текущего потока.

bufferSize

Int32

Размер (в байтах) буфера. Это значение должно быть больше нуля.

cancellationToken

CancellationToken

Токен для отслеживания запросов отмены.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию копирования.

Исключения

ArgumentNullException

destination имеет значение null.

ArgumentOutOfRangeException

Значение bufferSize не является положительным числом.

NotSupportedException

Поток не поддерживает чтение или запись.

ObjectDisposedException

Поток закрыт.

InvalidOperationException

Одновременно допускается только одно асинхронное средство чтения или модуля записи.

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые CopyTo(Stream, Int32).