CryptoStream.CopyToAsync(Stream, Int32, CancellationToken) 方法

定义

命名空间:

System.Security.Cryptography

程序集:

System.Security.Cryptography.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

缓冲区的大小（以字节为单位）。 此值必须大于零。 默认大小为 81920。

cancellationToken

CancellationToken

要监视取消请求的标记。 默认值为 None。

返回

Task

表示异步复制操作的任务。

例外

ArgumentNullException

destination 为 null。

ArgumentOutOfRangeException

buffersize 为负数或零。

ObjectDisposedException

当前流或目标流已释放。

NotSupportedException

当前流不支持阅读，或目标流不支持写入。

CryptographicException

在执行加密操作时出错。

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

复制从当前流中的当前位置开始，在复制操作完成后不会重置目标流的位置。

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 CopyTo(Stream, Int32)异常。