SeekableXPathNavigator.CurrentPosition Propiedad

Definición

Espacio de nombres:

System.ServiceModel.Dispatcher

Ensamblado:

System.ServiceModel.dll

Si se invalida en una clase derivada, obtiene o establece un valor asociado al nodo en los datos donde está ubicado el explorador 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

Valor de propiedad

Int64

Valor asociado a la posición actual del navegador.

Comentarios

La operación de set mueve el explorador a la posición asociada al valor especificado. La operación get devuelve un valor asociado a la posición actual del explorador.

Notas a los implementadores

Esta propiedad no tiene ningún significado intrínseco: es un valor opaco que una implementación asocia a la posición actual Int64 del navegador. El valor en sí mismo no tiene ninguna restricción ni requisito. No se puede hacer ninguna suposición sobre su estructura de datos interna.

No es necesario que los valores son secuenciales, ni siquiera que una posición del explorador se asigne a un valor único. Varios valores pueden hacer referencia a la misma posición del explorador, por lo que la comparación de dos valores no proporciona información útil.

Cualquier valor proporcionado por una operación get debe ser válido para una operación set. No es necesariamente un error que una operación set utilice un valor que una operación get no haya adquirido primero. Un valor no devuelto por CurrentPosition que se ha adquirido de alguna otra manera puede considerarse válido o no válido por la implementación: la decisión depende del implementador.

El significado de un valor no debe cambiar durante la duración del explorador mientras explora el mismo documento. Además, dos exploradores cualesquiera relacionados mediante la clonación deben compartir el significado de los valores, siempre que sigan explorando el mismo documento. Todos los valores proporcionados por una operación get deben seguir siendo válidos mientras dura un explorador y cualquiera de sus clones, siempre que la instancia siga explorando el mismo documento.