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 任务。