导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

Stream.CopyToAsync 方法 (Stream, Int32)

2013/12/13

从当前流异步读取字节并使用指定缓冲区大小向另一个流写入它们。

Namespace:  System.IO
程序集:  mscorlib(位于 mscorlib.dll 中)

public Task CopyToAsync(
	Stream destination,
	int bufferSize
)

参数

destination
类型: System.IO.Stream
将当前流的内容复制到的流。
bufferSize
类型: System.Int32
缓冲区的大小(以字节为单位)。该值必须大于零。默认大小为 4096。

返回值

类型: System.Threading.Tasks.Task
表示异步复制操作的任务。

异常条件
ArgumentNullException

destinationnull

ArgumentOutOfRangeException

buffersize 为负数或零。

ObjectDisposedException

当前流或目标流被释放。

NotSupportedException

当前流不支持读取,或目标流不支持写入。

CopyToAsync 方法使您能够执行资源密集型 I/O 操作,而不阻塞主线程。此性能注意事项在 Windows 商店 应用或 桌面 应用中尤其重要,因为在上述应用中,耗时的流操作可阻塞 UI 线程,并使您的应用看似未在工作。在 Visual Basic 和 C# 中,async 方法与 asyncawait 关键字结合使用。

复制从当前流中的当前位置开始。

有关在两个流之间进行复制的示例,请参见 CopyToAsync 重载。

Windows Phone OS

受以下版本支持: 8.0

显示:
© 2014 Microsoft