Stream.Seek(Int64, SeekOrigin) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスでオーバーライドされた場合は、現在のストリーム内の位置を設定します。
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 型の値。
戻り値
現在のストリーム内の新しい位置。
例外
I/O エラーが発生しました。
ストリームは、ストリームがパイプまたはコンソール出力から構築されている場合など、シークをサポートしていません。
ストリームが閉じられた後、メソッドが呼び出されました。
注釈
現在のインスタンスがシークをサポートしているかどうかを判断するには、 CanSeek プロパティを使用します。
offsetが負の値の場合、新しい位置は、originで指定された位置の前に、offsetで指定されたバイト数だけ前に置く必要があります。
offsetがゼロ (0) の場合、新しい位置は origin で指定された位置である必要があります。
offsetが正の場合、新しい位置は、offsetで指定されたバイト数でoriginで指定された位置に従う必要があります。
シークをサポートする Stream から派生したクラスは、上記の機能を提供するためにこのメソッドをオーバーライドする必要があります。
ストリームの長さを超える任意の場所へのシークがサポートされています。