System.IO.Stream.CopyTo 方法 (Stream, Int32)

方法描述

从当前流中读取所有字节并将其写入到目标流中(使用指定的缓冲区大小)。

语法定义

public void CopyTo(
	Stream destination,
	int bufferSize
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
destination System-IO-Stream 将包含当前流的内容的流。
bufferSize System-Int32 缓冲区的大小。此值必须大于零。默认大小为 4096。
返回值 void

提示和注释

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

System.IO.Stream.CopyTo 方法 (Stream, Int32)例子


异常

异常 异常描述
ArgumentNullException destination 为 null。
ArgumentOutOfRangeException bufferSize 为负或为零。
NotSupportedException
  • 当前流不支持读取。
  • destination 不支持写入。
ObjectDisposedException 在调用 CopyTo 方法之前关闭了当前流或 destination。
IOException 发生了 I/O 错误。

命名空间

namespace: System.IO

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4 .NET Framework Client Profile 受以下版本支持:4

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。