System.IO.Stream.Seek 方法

方法描述

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

语法定义(C# System.IO.Stream.Seek 方法 的用法)

public abstract long Seek(
	long offset,
	SeekOrigin origin
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
offset System-Int64 相对于 origin 参数的字节偏移量。
origin System-IO-SeekOrigin SeekOrigin 类型的值,指示用于获取新位置的参考点。
返回值 System.Int64 当前流中的新位置。

提示和注释

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

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

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

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

System.IO.Stream.Seek 方法例子


异常

异常 异常描述
IOException 发生 I/O 错误。
NotSupportedException 流不支持查找,例如在流通过管道或控制台输出构造的情况下即为如此。
ObjectDisposedException 在流关闭后调用方法。

命名空间

namespace: System.IO

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。