FileStream.Position プロパティ

定義

ストリームの現在位置を取得または設定します。Gets or sets the current position of this stream.

public:
 virtual property long Position { long get(); void set(long value); };
public override long Position { get; set; }
member this.Position : int64 with get, set
Public Overrides Property Position As Long

プロパティ値

ストリームの現在位置。The current position of this stream.

例外

このストリームはシークをサポートしていません。The stream does not support seeking.

I/O エラーが発生しました。An I/O error occurred.

または-or-

位置が、Windows 98 またはそれ以前のストリームの末尾を越える非常に大きな値に設定されました。The position was set to a very large value beyond the end of the stream in Windows 98 or earlier.

位置を負の値に設定しようとしました。Attempted to set the position to a negative value.

サポートされていない、ストリームの末尾を越えるシークをしようとしました。Attempted seeking past the end of a stream that does not support this.

次の例では、Length プロパティと Position プロパティを使用して、ファイルの終端の条件を確認します。The following example uses the Length and Position properties to check for an end-of-file condition.

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

注釈

ストリームの長さを超えた場所へのシークはサポートされています。Seeking to any location beyond the length of the stream is supported. ファイルの長さを超えてシークすると、ファイルサイズが大きくなります。When you seek beyond the length of the file, the file size grows. Microsoft Windows NT 以降では、ファイルの末尾に追加されたデータはゼロに設定されます。In Microsoft Windows NT and newer, any data added to the end of the file is set to zero. Microsoft Windows 98 またはそれ以前のバージョンでは、ファイルの末尾に追加されたデータは0に設定されていません。これは、以前に削除されたデータがストリームに表示されることを意味します。In Microsoft Windows 98 or earlier, any data added to the end of the file is not set to zero, which means that previously deleted data is visible to the stream. ストリームの位置を、Windows 98 以前のストリームの末尾を越える大きな値に設定すると、例外が発生する可能性があります。Setting the position of the stream to a large value beyond the end of the stream in Windows 98 or earlier may result in an exception being raised.

一般的なファイルおよびディレクトリ操作の一覧については、「一般的な I/o タスク」を参照してください。For a list of common file and directory operations, see Common I/O Tasks.

適用対象

こちらもご覧ください