BufferedStream.Seek(Int64, SeekOrigin) 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

BufferedStream.cs

設定目前緩衝資料流中的位置。

public:
 override long Seek(long offset, System::IO::SeekOrigin origin);

public override long Seek (long offset, System.IO.SeekOrigin origin);

override this.Seek : int64 * System.IO.SeekOrigin -> int64

Public Overrides Function Seek (offset As Long, origin As SeekOrigin) As Long

參數

offset

Int64

相對於 origin 的位元組位移。

origin

SeekOrigin

SeekOrigin 型別的值，表示用以取得新位置的參考點。

傳回

Int64

目前緩衝資料流中的新位置。

例外狀況

IOException

資料流未開啟或為 null。

NotSupportedException

資料流不支援搜尋。

ObjectDisposedException

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

備註

如果 offset 為負數，新的位置將在 origin 指定的位置之前由 offset 指定的位元組數。 如果 offset 為 0，則新位置會是 所 origin指定的位置。 如果 offset 為正值，新的位置則在 origin 指定的位置之後由 offset 指定的位元組數。

BufferedStream當對像是 物件的基底數據流StreamReader時，呼叫 Seek 方法可能會導致數據流的位置不再符合讀取器中內部緩衝區的位置。 若要重設內部緩衝區，請呼叫 StreamReader.DiscardBufferedData 方法;不過，這個方法會降低效能，而且只有在絕對必要時才應該呼叫。

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

另請參閱

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