System.IO.MemoryStream.Write 方法

方法描述

使用从某个缓冲区读取的数据将字节块写入当前流。

语法定义(C# System.IO.MemoryStream.Write 方法 的用法)

public override void Write(
	byte[] buffer,
	int offset,
	int count
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
buffer System-Byte[] 从中写入数据的缓冲区。
offset System-Int32 buffer 中的从零开始的字节偏移量,从此处开始将字节复制到当前流。
count System-Int32 最多写入的字节数。
返回值 void

提示和注释

此方法重写 Write。

offset 参数给出 buffer 中作为开始写入位置的第一个字节的偏移量,count 参数给出要写入的字节数。 如果写操作成功,则流的当前位置前进写入的字节数。 如果发生异常,则流内的当前位置不变。

除了用 byte[] 参数构造的 MemoryStream 外,MemoryStream 末尾的写操作扩展 MemoryStream。

System.IO.MemoryStream.Write 方法例子

此代码示例摘自为 MemoryStream 类提供的一个更大的示例。

// Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length);

异常

异常 异常描述
ArgumentNullException buffer 为 null。
NotSupportedException
  • 流不支持写入。 有关更多信息,请参见 CanWrite。
  • 当前位置到流结尾的距离小于 count 字节,并且无法修改容量。
ArgumentException 缓冲区长度减去 offset 的结果小于 count。
ArgumentOutOfRangeException offset 或 count 为负。
IOException 发生 I/O 错误。
ObjectDisposedException 当前流实例已关闭。

命名空间

namespace: System.IO

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

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

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