FileStream.SetLength 方法

项目
08/17/2007

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

**命名空间:**System.IO
**程序集:**mscorlib（在 mscorlib.dll 中）

语法

声明
Public Overrides Sub SetLength ( _
    value As Long _
)
用法
Dim instance As FileStream
Dim value As Long

instance.SetLength(value)

public override void SetLength (
    long value
)

public:
virtual void SetLength (
    long long value
) override

public void SetLength (
    long value
)

public override function SetLength (
    value : long
)

参数

value
流的新长度。

异常

异常类型	条件
IOException	出现 I/O 错误。
NotSupportedException	流不同时支持写入和查找。
ArgumentOutOfRangeException	试图将 value 参数设置为小于 0。

备注

此方法重写 SetLength。

如果给定值小于流的当前长度，则截断流。如果给定值大于流的当前长度，则扩展流。如果流被扩展，则新旧长度的流之间的内容是未定义的。

为了使 SetLength 生效，流必须支持写入和搜索。

提示

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

下表列出了其他典型或相关的 I/O 任务的示例。

若要执行此操作...	请参见本主题中的示例...
创建文本文件。	如何：向文件写入文本
写入文本文件。	如何：向文件写入文本
读取文本文件。	如何：从文件读取文本
向文件中追加文本。	如何：打开并追加到日志文件 File.AppendText FileInfo.AppendText
重命名或移动文件。	File.Move FileInfo.MoveTo
复制文件。	File.Copy FileInfo.CopyTo
获取目录的大小。	FileInfo.Length
获取文件属性。	File.GetAttributes
设置文件属性。	File.SetAttributes
创建子目录。	CreateSubdirectory
读取二进制文件。	如何：对新建的数据文件进行读取和写入
写入二进制文件。	如何：对新建的数据文件进行读取和写入
查看目录中的文件。	Name
按大小对目录中的文件排序。	GetFileSystemInfos

平台

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 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

通过

FileStream.SetLength 方法

语法

参数

异常

备注

平台

版本信息

.NET Framework

.NET Compact Framework

请参见

参考

其他资源

其他资源