CryptoStream.CopyToAsync(Stream, Int32, CancellationToken) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно считывает байты из базового потока, применяет соответствующие криптографические преобразования и записывает результат в целевой поток.
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.TaskPublic Overrides Function CopyToAsync (destination As Stream, bufferSize As Integer, cancellationToken As CancellationToken) As TaskПараметры
- destination
- Stream
Поток, в который будет скопировано содержимое текущего потока.
- bufferSize
- Int32
Размер (в байтах) буфера. Это значение должно быть больше нуля. Размер по умолчанию — 81920.
- cancellationToken
- CancellationToken
Токен для отслеживания запросов отмены. Значение по умолчанию — None.
Возвращаемое значение
Задача, представляющая асинхронную операцию копирования.
Исключения
destination имеет значение null.
Параметр buffersize имеет отрицательное значение или равен нулю.
Текущий поток или поток назначения удаляется.
Текущий поток не поддерживает чтение или поток назначения не поддерживает запись.
Во время выполнения операции шифрования произошла ошибка.
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Комментарии
Копирование начинается с текущей позиции в текущем потоке и не сбрасывает позицию целевого потока после завершения операции копирования.
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые CopyTo(Stream, Int32).
