Stream.Seek(Int64, SeekOrigin) 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

Source:

Stream.cs

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

public:
 abstract long Seek(long offset, System::IO::SeekOrigin origin);

public abstract long Seek (long offset, System.IO.SeekOrigin origin);

abstract member Seek : int64 * System.IO.SeekOrigin -> int64

Public MustOverride Function Seek (offset As Long, origin As SeekOrigin) As Long

参数

offset

Int64

相对于 origin 参数的字节偏移量。

origin

SeekOrigin

SeekOrigin 类型的值，指示用于获取新位置的参考点。

返回

Int64

当前流中的新位置。

例外

IOException

出现 I/O 错误。

NotSupportedException

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

ObjectDisposedException

在流关闭后调用方法。

注解

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

如果 offset 为负数，则新位置需要位于 由 origin 指定的字节数所指定 offset的位置之前。 如果 offset 为零 (0) ，则新位置必须是 指定 origin的位置。 如果 offset 为正数，则新位置必须遵循 由 origin 指定的字节数所指定 offset的位置。

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

支持查找超出流长度的任何位置。

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件