SeekableXPathNavigator.CurrentPosition Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Quando é sobreposto numa classe derivada, recebe ou define um valor associado ao nó nos dados onde o navegador XPath está 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 de Propriedade
Um valor associado à posição atual do navegador.
Observações
A set operação move o navegador para a posição associada ao valor especificado. A get operação devolve um valor associado à posição atual do navegador.
Notas para Implementadores
Esta propriedade não tem qualquer significado intrínseco: é um valor opaco Int64 que uma implementação associa à posição atual do navegador. Não são impostas restrições ou requisitos ao valor em si. Não se podem fazer suposições sobre a sua estrutura de dados interna.
Não é obrigatório que os valores sejam sequenciais, nem sequer que a posição do navegador corresponda a um valor único. Múltiplos valores podem referir-se à mesma posição do navegador, por isso comparar dois valores não fornece informação útil.
Qualquer valor fornecido por uma get operação deve ser válido para uma set operação. Não é necessariamente um erro uma operação set usar um valor que não foi adquirido primeiro por uma get operação. Um valor não devolvido por CurrentPosition que foi adquirido de outra forma pode ou não ser considerado válido pela implementação: esta escolha cabe ao implementador.
O significado de um valor não deve mudar durante a vida do seu navegador enquanto navega pelo mesmo documento. Além disso, o significado dos valores deve ser partilhado por quaisquer dois navegadores relacionados por clonagem, novamente, desde que ainda naveguem pelo mesmo documento. Todos os valores fornecidos por uma get operação devem permanecer válidos durante toda a vida de um navegador e de qualquer um dos seus clones, desde que a instância ainda navegue pelo mesmo documento.