Stream.Seek 方法

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

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

语法

声明
Public MustOverride Function Seek ( _
    offset As Long, _
    origin As SeekOrigin _
) As Long
用法
Dim instance As Stream
Dim offset As Long
Dim origin As SeekOrigin
Dim returnValue As Long

returnValue = instance.Seek(offset, origin)
public abstract long Seek (
    long offset,
    SeekOrigin origin
)
public:
virtual long long Seek (
    long long offset, 
    SeekOrigin origin
) abstract
public abstract long Seek (
    long offset, 
    SeekOrigin origin
)
public abstract function Seek (
    offset : long, 
    origin : SeekOrigin
) : long

参数

  • offset
    相对于 origin 参数的字节偏移量。
  • origin
    SeekOrigin 类型的值,指示用于获取新位置的参考点。

返回值

当前流中的新位置。

异常

异常类型 条件

IOException

发生 I/O 错误。

NotSupportedException

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

ObjectDisposedException

在流关闭后调用方法。

备注

有关创建文件和向文件中写入文本的示例,请参见 如何:向文件写入文本。有关从文件中读取文本的示例,请参见 如何:从文件读取文本。有关读取和写入二进制文件的示例,请参见 如何:对新建的数据文件进行读取和写入

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

如果 offset 为负,则要求新位置位于 origin 指定的位置之前,其间隔相差 offset 指定的字节数。如果 offset 为零 (0),则要求新位置位于由 origin 指定的位置处。如果 offset 为正,则要求新位置位于 origin 指定的位置之后,其间隔相差 offset 指定的字节数。

Stream 派生且支持查找的类必须重写此方法以提供上述功能。

支持搜索到超出流长度的任何位置。

平台

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 命名空间

其他资源

文件和流 I/O
如何:从文件读取文本
如何:向文件写入文本