FileStream.Position プロパティ

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

FileStream.Position プロパティ

ストリームの現在位置を取得または設定します。

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

Visual Basic (宣言)

Public Overrides Property
 Position As Long

Visual Basic (使用法)

Dim instance As FileStream
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)

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

例外

例外の種類	条件
NotSupportedException	ストリームがシークをサポートしていません。
IOException	I/O エラーが発生しました。 または Windows 98 以前で、位置がストリームの末尾を超えた非常に大きな値に設定されています。
ArgumentOutOfRangeException	位置を負の値に設定しようとしました。
EndOfStreamException	シークをサポートしていないストリームの末尾を超える位置で、シークを試行しました。

解説

ストリーム長を超えた位置へのシークがサポートされています。ファイルの長さを超えてシークすると、ファイル サイズが大きくなります。Microsoft Windows NT 以降では、ファイルの末尾に追加されたデータは、すべて 0 に設定されます。Windows 98 以前では、ファイルの末尾に追加されたデータは 0 に設定されません。つまり、以前に削除されたデータがストリームに対して可視になります。Windows 98 以前でストリームの位置をストリームの末尾を超えた大きな値に設定すると、例外が発生する場合があります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキスト ファイルを作成する。	方法 : ファイルにテキストを書き込む
テキスト ファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキスト ファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログ ファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ディレクトリのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
サブディレクトリを作成する。	CreateSubdirectory
バイナリ ファイルから読み取る。	方法 : 新しく作成されたデータ ファイルに対して読み書きする
バイナリ ファイルに書き込む。	方法 : 新しく作成されたデータ ファイルに対して読み書きする
ディレクトリ内のファイルを参照する。	Name
ディレクトリ内のファイルをサイズ順に並べ替える。	GetFileSystemInfos

使用例

Length プロパティと Position プロパティを使用して EOF (end-of-file) 条件を確認する例を次に示します。

Visual Basic

If s.Length = s.Position Then
    Console.WriteLine("End of file has been reached.")
End If

C#

if( s.Length==s.Position )
{
   Console.WriteLine("End of file has been reached.");
}

C++

if ( s->Length == s->Position )
{
   Console::WriteLine( "End of file has been reached." );
}

J#

if (s.get_Length() == s.get_Position()) {
    Console.WriteLine("End of file has been reached.");
}

JScript

if( s.Length==s.Position )
    Console.WriteLine("End of file has been reached.");

プラットフォーム

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

参照

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