Stream.Seek(Int64, SeekOrigin) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
当在派生类中重写时,设置当前流中的位置。
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 类型的值,指示用于获取新位置的参考点。
返回
当前流中的新位置。
例外
出现 I/O 错误。
流不支持查找,例如在流通过管道或控制台输出构造的情况下即为如此。
在流关闭后调用方法。
注解
CanSeek使用 属性可确定当前实例是否支持查找。
如果 offset
为负数,则新位置需要位于 由 origin
指定的字节数所指定 offset
的位置之前。 如果 offset
为零 (0) ,则新位置必须是 指定 origin
的位置。 如果 offset
为正数,则新位置必须遵循 由 origin
指定的字节数所指定 offset
的位置。
派生自 Stream
支持查找的类必须重写此方法以提供上述功能。
支持查找超出流长度的任何位置。