Stream.Seek(Int64, SeekOrigin) 方法

定义

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

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

当前流中的新位置。

例外

出现 I/O 错误。

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

在流关闭后调用方法。

注解

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

如果 offset 为负,则需要在由指定的字节数之前指定的新位置 origin offset 。 如果 offset 为零 (0) ,则新位置需要是指定的位置 origin 。 如果 offset 为正,则需要在由指定的字节数后跟随新位置 origin offset

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

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

适用于

另请参阅