MemoryStream.SetLength(Int64) 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

Source:

MemoryStream.cs

将当前流的长度设为指定值。

public:
 override void SetLength(long value);

public override void SetLength (long value);

override this.SetLength : int64 -> unit

Public Overrides Sub SetLength (value As Long)

参数

value

Int64

用于设置长度的值。

例外

NotSupportedException

当前流无法调整大小，而且 value 大于当前容量。

- 或 -

当前流不支持写入。

ArgumentOutOfRangeException

value 为负或大于 的最大长度 MemoryStream，其中最大长度 (Int32.MaxValue - origin) ，是 origin 流开始的基础缓冲区的索引。

注解

此方法重写 SetLength。

如果指定的值小于流的当前长度，则流将被截断。 如果在截断后流中的当前位置超过流的末尾，该方法ReadByte将返回 -1，该方法Read将零个字节读取到提供的字节数组中，并且WriteWriteByte方法在流的末尾追加指定的字节，从而增加其长度。 如果指定的值大于当前容量，并且流可调整大小，则容量将增加，并且流中的当前位置保持不变。 如果长度增加，则新旧长度之间的流内容将初始化为零。

注意

实例 MemoryStream 必须支持编写才能使此方法正常工作。 CanWrite使用 属性确定当前实例是否支持写入。 有关附加信息，请参见 CanWrite。

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件