Stream.Seek(Int64, SeekOrigin) 方法

  • 參考

定義

命名空間:
System.IO
組件:
System.IO.dll
組件:
System.Runtime.dll
組件:
netstandard.dll
組件:
mscorlib.dll

在衍生類別中覆寫時，設定在目前資料流的位置。

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

資料流不支援搜尋，例如資料流為管道或主控台 (Console) 輸出所建構。

ObjectDisposedException

關閉資料流後呼叫了方法。

備註

您 CanSeek 可以使用屬性來判斷目前的實例是否支援搜尋。

如果 offset 是負數，則新的位置必須在指定的位置之前，以 origin 指定的位元組數目 offset 。 如果 offset 是零 (0) ，則新的位置必須是所指定的位置 origin 。 如果 offset 是正數，則需要新的位置，才能依照所指定的位元組數目，在所指定的位置 origin offset 。

衍生自 Stream 該支援搜尋的類別必須覆寫這個方法，以提供上述功能。

支援搜尋超出資料流程長度的任何位置。

適用於

另請參閱