FileStream.Position Property

Reference

Definition

Namespace:: System.IO

Assemblies:: mscorlib.dll, System.IO.FileSystem.dll

Assembly:: System.Runtime.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: FileStream.cs

Source:: FileStream.cs

Source:: FileStream.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Property Value

Int64

The current position of this stream.

Exceptions

NotSupportedException

The stream does not support seeking.

IOException

An I/O error occurred.

ArgumentOutOfRangeException

Attempted to set the position to a negative value.

EndOfStreamException

Attempted seeking past the end of a stream that does not support this.

Examples

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
    printfn "End of file has been reached."

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

Remarks

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. Any data added to the end of the file is set to zero.

For a list of common file and directory operations, see Common I/O Tasks.

Applies to

Del via