SeekableXPathNavigator.CurrentPosition Propriedade

Definição

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Quando substituído em uma classe derivada, obtém ou define um valor associado ao nó nos dados em que o navegador XPath é posicionado.

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

Valor da propriedade

Int64

Um valor que está associado à posição atual do navegador.

Comentários

A set operação move o navegador para a posição associada ao valor especificado. A get operação retorna um valor associado à posição atual do navegador.

Notas aos Implementadores

Essa propriedade não tem nenhum significado intrínseco: é um Int64 valor opaco que uma implementação associa à posição atual do navegador. Nenhuma restrição ou requisito é colocado no próprio valor. Não é possível fazer suposições sobre sua estrutura de dados interna.

Não é necessário que os valores sejam sequenciais ou mesmo que uma posição de navegador seja mapeada para um valor exclusivo. Vários valores podem se referir à mesma posição do navegador, portanto, comparar dois valores não fornece informações úteis.

Qualquer valor fornecido por uma get operação deve ser válido para uma set operação. Não é necessariamente um erro para uma set operação usar um valor não adquirido primeiro por uma get operação. Um valor não retornado pelo CurrentPosition que foi adquirido de alguma outra maneira pode ou não ser considerado válido pela implementação: essa opção é até o implementador.

O significado de um valor não deve ser alterado durante a vida útil de seu navegador enquanto navega pelo mesmo documento. Além disso, o significado dos valores deve ser compartilhado por dois navegadores que estão relacionados pela clonagem, desde que eles ainda naveguem no mesmo documento. Todos os valores fornecidos por uma get operação devem permanecer válidos durante a vida útil de um navegador e em qualquer um de seus clones, desde que a instância ainda navegue no mesmo documento.