Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

MemoryStream.Seek Method

Sets the position within the current stream to the specified value.

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)
public override long Seek(
	long offset,
	SeekOrigin loc
)

Parameters

offset
Type: System.Int64

The new position within the stream. This is relative to the loc parameter, and can be positive or negative.

loc
Type: System.IO.SeekOrigin

A value of type SeekOrigin, which acts as the seek reference point.

Return Value

Type: System.Int64
The new position within the stream, calculated by combining the initial reference point and the offset.
ExceptionCondition
IOException

Seeking is attempted before the beginning of the stream.

ArgumentOutOfRangeException

offset is greater than MaxValue.

ArgumentException

There is an invalid SeekOrigin.

-or-

offset caused an arithmetic overflow.

ObjectDisposedException

The current stream instance is closed.

This method overrides Stream.Seek.

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

Do not use the Seek method to determine the new position in the stream if the MemoryStream was initialized with a non-zero offset. If you do, Seek will return an inaccurate value. Instead, use the Position property to get the new position of the stream.

This code example is part of a larger example provided for the MemoryStream class.

// Set the position to the beginning of the stream.
memStream.Seek(0, SeekOrigin.Begin);

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

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