BufferedStream.Seek(Int64, SeekOrigin) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のバッファー ストリーム内の位置を設定します。
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 型の値。
返品
現在のバッファー ストリーム内の新しい位置。
例外
ストリームが開かっていないか、 null。
ストリームはシークをサポートしていません。
ストリームが閉じられた後、メソッドが呼び出されました。
注釈
offsetが負の値の場合、新しい位置は、originで指定された位置の前に、offsetで指定されたバイト数だけ先行します。
offsetが 0 の場合、新しい位置はoriginで指定された位置になります。
offsetが正の場合、新しい位置は、originで指定されたバイト数でoffset指定された位置に従います。
BufferedStream オブジェクトがStreamReader オブジェクトの基本ストリームである場合、Seek メソッドを呼び出すと、ストリームの位置がリーダー内の内部バッファーの位置と一致しなくなる可能性があります。 内部バッファーをリセットするには、 StreamReader.DiscardBufferedData メソッドを呼び出します。ただし、このメソッドはパフォーマンスを低下させ、絶対に必要な場合にのみ呼び出す必要があります。
ストリームの長さを超える任意の場所へのシークがサポートされています。