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

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

Source:

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

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

cancellationToken

CancellationToken

要监视取消请求的标记。

返回

Task

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

例外

ArgumentNullException

destination 为 null。

ArgumentOutOfRangeException

buffersize 为负数或零。

ObjectDisposedException

当前流或目标流已释放。

NotSupportedException

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

OperationCanceledException

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

注解

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