英語で読む

次の方法で共有


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

定義

派生クラスでオーバーライドされた場合は、現在のストリーム内の位置を設定します。

C#
public abstract long Seek (long offset, System.IO.SeekOrigin origin);

パラメーター

offset
Int64

origin パラメーターからの相対バイト オフセット。

origin
SeekOrigin

新しい位置を取得するために使用する参照ポイントを示す SeekOrigin 型の値。

戻り値

現在のストリーム内の新しい位置。

例外

I/O エラーが発生します。

ストリームがシークをサポートしていません。たとえば、ストリームがパイプまたはコンソール出力によって生成された可能性があります。

ストリームが閉じた後でメソッドが呼び出されました。

注釈

プロパティを使用して、 CanSeek 現在のインスタンスがシークをサポートしているかどうかを判断します。

が負の場合 offset は、 で指定された位置の前に、 で origin 指定された offsetバイト数の前に新しい位置が必要です。 がゼロ (0) の場合 offset 、新しい位置は で origin指定された位置である必要があります。 が正の場合 offset 、新しい位置は、 で指定されたバイト数で origin 指定 offsetされた位置に従う必要があります。

シークをサポートする から 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

こちらもご覧ください