Stream.Seek(Int64, SeekOrigin) メソッド

定義

派生クラスでオーバーライドされた場合は、現在のストリーム内の位置を設定します。When overridden in a derived class, sets the position within the current stream.

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 パラメーターからの相対バイト オフセット。A byte offset relative to the origin parameter.

origin
SeekOrigin

新しい位置を取得するために使用する参照ポイントを示す SeekOrigin 型の値。A value of type SeekOrigin indicating the reference point used to obtain the new position.

戻り値

Int64

現在のストリーム内の新しい位置。The new position within the current stream.

例外

I/O エラーが発生します。An I/O error occurs.

ストリームがシークをサポートしていません。たとえば、ストリームがパイプまたはコンソール出力によって生成された可能性があります。The stream does not support seeking, such as if the stream is constructed from a pipe or console output.

ストリームが閉じた後でメソッドが呼び出されました。Methods were called after the stream was closed.

注釈

CanSeek現在のインスタンスがシークをサポートしているかどうかを確認するには、プロパティを使用します。Use the CanSeek property to determine whether the current instance supports seeking.

offsetが負の値の場合、で指定した位置の前に、で指定したバイト数だけ新しい位置が必要に origin offset なります。If offset is negative, the new position is required to precede the position specified by origin by the number of bytes specified by offset. offsetがゼロ (0) の場合、新しい位置はで指定された位置である必要があり origin ます。If offset is zero (0), the new position is required to be the position specified by origin. が正の値の場合、によって指定された位置に従うために、で指定された offset バイト数だけ新しい位置が必要に origin offset なります。If offset is positive, the new position is required to follow the position specified by origin by the number of bytes specified by offset.

シークをサポートするから派生 Stream したクラスは、このメソッドをオーバーライドして、前述の機能を提供する必要があります。Classes derived from Stream that support seeking must override this method to provide the functionality described above.

ストリームの長さを超えた場所へのシークはサポートされています。Seeking to any location beyond the length of the stream is supported.

適用対象

こちらもご覧ください