Stream.Seek(Int64, SeekOrigin) 方法

定义

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

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

参数

offset
Int64

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

origin
SeekOrigin

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

返回

当前流中的新位置。

例外

出现 I/O 错误。

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

在流关闭后调用方法。

注解

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

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

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

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

适用于

产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

另请参阅