BufferedStream.Position プロパティ

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

BufferedStream.Position プロパティ

現在のストリーム内の位置を取得します。

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

Visual Basic (宣言)

Public Overrides Property
 Position As Long

Visual Basic (使用法)

Dim instance As BufferedStream
Dim value As Long

value = instance.Position

instance.Position = value

C#

public override long Position { get; set;
 }

C++

public:
virtual property long long Position {
    long long get () override;
    void set (long long value) override;
}

J#

/** @property */
public long get_Position ()

/** @property */
public void set_Position (long value)

JScript

public override function get
 Position () : long

public override function set
 Position (value : long)

プロパティ値
現在のストリーム内の位置。

例外

例外の種類	条件
ArgumentOutOfRangeException	Seek に渡される値が負の値です。
IOException	I/O エラーが発生しました。たとえば、ストリームが終了されています。
NotSupportedException	ストリームがシークをサポートしていません。
ObjectDisposedException	ストリームが閉じられた後でメソッドが呼び出されました。

解説

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

get アクセサは、Seek を呼び出して、基になるストリームの現在位置を取得してから、バッファの現在位置に従ってこの値を調整します。

set アクセサは、以前にバッファに書き込まれたデータを基になるストリームにコピーしてから、Seek を呼び出します。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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