This documentation is archived and is not being maintained.

SeekableXPathNavigator.CurrentPosition Property

When overridden in a derived class, gets or sets a value associated with the node in the data where the XPath navigator is positioned.

Namespace:  System.ServiceModel.Dispatcher
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public abstract long CurrentPosition { get; set; }

Property Value

Type: System.Int64
A value that is associated with the navigator’s current position.

The set operation moves the navigator to the position associated with the value specified. The get operation returns a value associated with the current position of the navigator.

Notes to Implementers

This property does not have any intrinsic meaning: it is an opaque Int64 value that an implementation associates with the navigator’s current position. No restrictions or requirements are placed on the value itself. No assumptions about its internal data structure can be made.

It is not required that the values be sequential, or even that a navigator position map to a unique value. Multiple values can refer to the same navigator position, so comparing two values does not provide useful information.

Any value supplied by a get operation must be valid for a set operation. It is not necessarily an error for a set operation to use a value not first acquired by a get operation. A value not returned by CurrentPosition that has been acquired some other way may or may not be considered valid by the implementation: this choice is up to the implementer.

The meaning of a value must not change during the life of its navigator while it navigates the same document. Also, the meaning of values must be shared by any two navigators that are related by cloning, again, provided they still navigate the same document. All values supplied by a get operation must remain valid for the life of a navigator and any of its clones as long as the instance still navigates the same document.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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