FileStream.SetLength(Int64) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将该流的长度设置为给定值。

public:
 override void SetLength(long value);

public override void SetLength (long value);

override this.SetLength : int64 -> unit

Public Overrides Sub SetLength (value As Long)

流的新长度。

IOException

发生了 I/O 错误。

该流不支持写入和查找。

试图将 value 参数设置为小于 0。

此方法重写 SetLength。

如果给定值小于流的当前长度，则会截断该流。在此方案中，如果当前位置大于新长度，则当前位置将移动到流的最后一个字节。如果给定值大于流的当前长度，则流将展开，并且当前位置保持不变。如果流已展开，则旧长度和新长度之间的流内容在 Windows 上未定义，而在 Linux 上，该空间用零填充。

流必须同时支持写入和寻求 SetLength 工作。

注意

CanWrite使用属性确定当前实例是否支持写入，使用 CanSeek 属性确定是否支持查找。有关更多信息，请参阅 CanWrite 和 CanSeek。

有关常见文件和目录操作的列表，请参阅常见 I/O 任务。