Stream.SetLength(Int64) 方法

定义

当在派生类中重写时,设置当前流的长度。

C#
public abstract void SetLength (long value);

参数

value
Int64

所需的当前流的长度(以字节表示)。

例外

出现 I/O 错误。

流不支持写入和查找,例如在流通过管道或控制台输出构造的情况下即为如此。

在流关闭后调用方法。

注解

如果指定的值小于流的当前长度,则会截断该流。 如果指定的值大于流的当前长度,则扩展流。 如果流已展开,则不会定义新旧长度之间的流内容。

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

CanWrite使用 属性确定当前实例是否支持写入,使用 CanSeek 属性确定是否支持查找。

适用于

产品 版本
.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.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

另请参阅