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

产品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0