Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
This topic has not yet been rated - Rate this topic

BufferedStream.Position Property

Gets the position within the current stream.

[Visual Basic]
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);

Property Value

The position within the current stream.

Exceptions

Exception Type Condition
ArgumentOutOfRangeException The value passed to Seek is negative.
IOException An I/O error occurs, such as the stream being closed.
NotSupportedException The stream does not support seeking.
ObjectDisposedException Methods were called after the stream was closed.

Remarks

For an example of creating a file and writing text to a file, see Writing Text to a File. For an example of reading text from a file, see Reading Text from a File. For an example of reading from and writing to a binary file, see Reading and Writing to a Newly Created Data File.

The get accessor invokes Seek to obtain the current position within the underlying stream and then adjusts this value according to the current position within the buffer.

The set accessor copies any data previously written to the buffer to the underlying stream, and then invokes Seek.

Seeking to any location beyond the length of the stream is supported.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

BufferedStream Class | BufferedStream Members | System.IO Namespace | CanSeek | Seek | Working with I/O | Reading Text from a File | Writing Text to a File

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.