SeekableXPathNavigator.CurrentPosition Propriedade
Definição
Quando substituído em uma classe derivada, obtém ou define um valor associado ao nó nos dados em que o navegador XPath é posicionado.When overridden in a derived class, gets or sets a value associated with the node in the data where the XPath navigator is positioned.
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
Um valor que está associado à posição atual do navegador.A value that is associated with the navigator's current position.
Comentários
A set operação move o navegador para a posição associada ao valor especificado.The set operation moves the navigator to the position associated with the value specified. A get operação retorna um valor associado à posição atual do navegador.The get operation returns a value associated with the current position of the navigator.
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.This property does not have any intrinsic meaning: it is an opaque Int64 value that an implementation associates with the navigator's current position. Nenhuma restrição ou requisito é colocado no próprio valor.No restrictions or requirements are placed on the value itself. Não é possível fazer suposições sobre sua estrutura de dados interna.No assumptions about its internal data structure can be made.
Não é necessário que os valores sejam sequenciais ou mesmo que uma posição de navegador seja mapeada para um valor exclusivo.It is not required that the values be sequential, or even that a navigator position map to a unique value. Vários valores podem se referir à mesma posição do navegador, portanto, comparar dois valores não fornece informações úteis.Multiple values can refer to the same navigator position, so comparing two values does not provide useful information.
Qualquer valor fornecido por uma get operação deve ser válido para uma set operação.Any value supplied by a get operation must be valid for a set operation. Não é necessariamente um erro para uma set operação usar um valor não adquirido primeiro por uma get operação.It is not necessarily an error for a set operation to use a value not first acquired by a get operation. 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.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.
O significado de um valor não deve ser alterado durante a vida útil de seu navegador enquanto navega pelo mesmo documento.The meaning of a value must not change during the life of its navigator while it navigates the same document. 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.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. 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.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.