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).
