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

  • Ссылка

Определение

Пространство имен:
System.IO
Сборка:
System.IO.dll
Сборка:
System.Runtime.dll
Сборка:
System.Runtime.Extensions.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

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

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 имеет отрицательное значение или равен нулю.

ObjectDisposedException

Текущий поток или поток назначения удаляется.

NotSupportedException

Текущий поток не поддерживает чтение или поток назначения не поддерживает запись.

OperationCanceledException

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

Комментарии

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

Применяется к