SeekableXPathNavigator.CurrentPosition Свойство

  • Ссылка

Определение

Пространство имен:
System.ServiceModel.Dispatcher
Сборка:
System.ServiceModel.dll

При переопределении в производном классе возвращает или задает значение, связанное с узлом данных, на который указывает навигатор XPath.

public:
 abstract property long CurrentPosition { long get(); void set(long value); };
public abstract long CurrentPosition { get; set; }
member this.CurrentPosition : int64 with get, set
Public MustOverride Property CurrentPosition As Long

Значение свойства

Int64

Значение, связанное с текущей позицией навигатора.

Комментарии

Операция set перемещает курсор навигатора в позицию, связанную с указанным значением. Операция get возвращает значение, связанное с текущей позицией курсора навигатора.

Примечания для тех, кто реализует этот метод

Это свойство не имеет какого-либо внутреннего значения: это непрозрачное Int64 значение, которое реализация связывает с текущей позицией навигатора. Для значения не определены какие-либо ограничения или требования. Нельзя строить какие-либо предположения относительно внутренней структуры данных.

Не требуется, чтобы значения были последовательными, или чтобы позиция навигатора соответствовала уникальному значению. Одной позиции курсора навигатора могут соответствовать разные значения, поэтому сравнение двух значений не дает полезной информации.

Любое значение, возвращенное операцией get, должно быть допустимым для операции set. Не будет ошибкой использовать для операции set значение, которое не было сначала получено операцией get. Значение, не возвращенное свойством CurrentPosition, которое было получено иным способом, в конкретной реализации может не считаться допустимым: это решение принимает разработчик.

Смысл значения не должен изменяться во время существования навигатора, пока он находится в одном документе. Кроме того, смысл значений должен быть одинаков для любых двух навигаторов, связанных через клонирование, если они также находятся в одном документе. Все значения, поставляемые операцией get, должны оставаться допустимыми в течение всего времени существования навигатора и его клонов, пока экземпляр остается в том же документе.

Применяется к