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

Определение

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

System.Security.Cryptography

Сборка:

System.Security.Cryptography.dll

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

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

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

cancellationToken

CancellationToken

Токен для отслеживания запросов отмены. Значение по умолчанию — None.

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

Task

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

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

Параметр buffersize имеет отрицательное значение или равен нулю.

ObjectDisposedException

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

NotSupportedException

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

CryptographicException

Во время выполнения операции шифрования произошла ошибка.

OperationCanceledException

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

Комментарии

Копирование начинается с текущей позиции в текущем потоке и не сбрасывает позицию целевого потока после завершения операции копирования.

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