Stream.Seek(Int64, SeekOrigin) 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

Stream.cs

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

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 為負數，則需要新位置，才能在 所指定的位元元組數目所offset指定origin的位置之前。 如果 offset 為零 (0) ，則新位置必須是 所 origin指定的位置。 如果 offset 為正數，則新位置必須遵循 所指定的位元組數目所offset指定的origin位置。

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

支援搜尋超過數據流長度的任何位置。

另請參閱

• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案