Stream.Seek メソッド

.NET Framework クラス ライブラリ リファレンス

Stream.Seek メソッド

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

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Function
 Seek ( _
    offset As Long, _
    origin As SeekOrigin _
) As Long

Visual Basic (使用法)

Dim instance As Stream
Dim offset As Long
Dim origin As SeekOrigin
Dim returnValue As Long

returnValue = instance.Seek(offset, origin)

C#

public abstract long Seek (
    long offset,
    SeekOrigin origin
)

C++

public:
virtual long long Seek (
    long long offset, 
    SeekOrigin origin
) abstract

J#

public abstract long Seek (
    long offset, 
    SeekOrigin origin
)

JScript

public abstract function Seek (
    offset : long, 
    origin : SeekOrigin
) : long

パラメータ

offset

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

origin

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

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

例外

例外の種類	条件
IOException	I/O エラーが発生しました。
NotSupportedException	ストリームがシークをサポートしていません。たとえば、ストリームがパイプまたはコンソール出力によって生成された可能性があります。
ObjectDisposedException	ストリームが閉じられた後でメソッドが呼び出されました。

解説

ファイルの作成およびテキストのファイルへの書き込みの例については、「方法 : ファイルにテキストを書き込む」を参照してください。ファイルからのテキストの読み取りの例については、「方法 : ファイルからテキストを読み取る」を参照してください。バイナリ ファイルの読み取りおよび書き込みの例については、「方法 : 新しく作成されたデータ ファイルに対して読み書きする」を参照してください。

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

offset が負の値の場合は、origin で指定した位置から offset で指定したバイト数だけさかのぼった位置が新しい位置になります。offset が 0 の場合は、origin で指定した位置が新しい位置になります。offset が正の値の場合は、origin で指定した位置から offset で指定したバイト数だけ進んだ位置が新しい位置になります。

上記の機能を提供するには、シークをサポートする Stream の派生クラスでこのメソッドをオーバーライドする必要があります。

ストリーム長を超えた位置へのシークがサポートされています。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Stream クラス
Stream メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む