FileStream.Position プロパティ

[アーティクル]
03/28/2008

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

Overrides Public Property Position As Long
[C#]
public override long Position {get; set;}
[C++]
public: __property __int64 get_Position();public: __property void set_Position(__int64);
[JScript]
public override function get Position() : long;public override function set Position(long);

プロパティ値

ストリームの現在位置。

例外

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

解説

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

このプロパティの使用例については、以下の「使用例」を参照してください。その他の一般的な 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) 条件を確認する例を次に示します。

 
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(S"End of file has been reached.");
}

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

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

次の方法で共有

FileStream.Position プロパティ

プロパティ値

例外

解説

使用例

必要条件

参照

その他のリソース