Stream.Seek(Int64, SeekOrigin) 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在衍生類別中覆寫時，設定在目前資料流的位置。
public:
abstract long Seek(long offset, System::IO::SeekOrigin origin);C#
public abstract long Seek (long offset, System.IO.SeekOrigin origin);abstract member Seek : int64 * System.IO.SeekOrigin -> int64Public MustOverride Function Seek (offset As Long, origin As SeekOrigin) As Long- offset
- Int64
相對於 origin 參數的位元組位移。
- origin
- SeekOrigin
SeekOrigin 類型的值，表示用來取得新位置的參考點。
目前資料流的新位置。
發生 I/O 錯誤。
資料流不支援搜尋，例如資料流為管道或主控台 (Console) 輸出所建構。
關閉資料流後呼叫了方法。
CanSeek使用屬性來判斷目前實例是否支持搜尋。
如果 offset 為負數，則需要新位置，才能在 所指定的位元元組數目所offset指定origin的位置之前。 如果 offset 為零 (0) ，則新位置必須是 所 origin指定的位置。 如果 offset 為正數，則新位置必須遵循 所指定的位元組數目所offset指定的origin位置。
衍生自 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 |
