Stream.SetLength 方法
当在派生类中重写时，设置当前流的长度。
**命名空间:**System.IO
**程序集:**mscorlib（在 mscorlib.dll 中）
语法
声明
Public MustOverride Sub SetLength ( _
value As Long _
)
用法
Dim instance As Stream
Dim value As Long
instance.SetLength(value)
public abstract void SetLength (
long value
)
public:
virtual void SetLength (
long long value
) abstract
public abstract void SetLength (
long value
)
public abstract function SetLength (
value : long
)
参数
- value
所需的当前流的长度（以字节表示）。
异常
| 异常类型 | 条件 |
|---|---|
发生 I/O 错误。 |
|
流不支持写入和查找，例如在流通过管道或控制台输出构造的情况下即为如此。 |
|
在流关闭后调用方法。 |
备注
有关创建文件和向文件中写入文本的示例，请参见 如何：向文件写入文本。有关从文件中读取文本的示例，请参见 如何：从文件读取文本。有关读取和写入二进制文件的示例，请参见 如何：对新建的数据文件进行读取和写入。
如果指定值小于流的当前长度，则流被截断。如果指定值大于当前流的长度，则流被扩展。如果流被扩展，则流的新旧长度之间的内容是未定义的。
为了使 SetLength 生效，流必须支持写入和搜索。
使用 CanWrite 属性确定当前实例是否支持写入，使用 CanSeek 属性确定是否支持查找。
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
.NET Compact Framework
受以下版本支持：2.0、1.0
请参见
参考
Stream 类
Stream 成员
System.IO 命名空间