SeekableXPathNavigator.CurrentPosition Vlastnost

Definice

Obor názvů:

System.ServiceModel.Dispatcher

Sestavení:

System.ServiceModel.dll

Při přepsání v odvozené třídě získává nebo nastavuje hodnotu přidruženou k uzlu v datech, kde je umístěn navigátor 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

Hodnota vlastnosti

Int64

Hodnota, která je přidružena k aktuální pozici navigátoru.

Poznámky

setOperace přesune navigátor na pozici přidruženou k zadané hodnotě. getOperace vrátí hodnotu přidruženou k aktuální pozici navigátoru.

Poznámky pro implementátory

Tato vlastnost nemá žádný vnitřní význam: Jedná se o neprůhlednou Int64 hodnotu, kterou implementace přidruží k aktuální pozici navigátoru. Do samotné hodnoty nejsou vložena žádná omezení ani požadavky. Nelze vytvořit žádné předpoklady o jeho vnitřních datových strukturách.

Není nutné, aby hodnoty byly sekvenční, nebo i v případě, že je pozice navigátoru mapována na jedinečnou hodnotu. Na stejnou pozici navigátoru může odkazovat více hodnot, takže porovnání dvou hodnot neposkytuje užitečné informace.

Jakákoli hodnota poskytnutá get operací musí být platná pro set operaci. Není nutně nutné, set aby operace použila hodnotu, která nebyla poprvé získána get operací. Hodnota, kterou nevrátila CurrentPosition , která byla získána jiným způsobem, může nebo nemusí být považována za platnou implementací: Tato volba je až k implementátoru.

Význam hodnoty se nesmí během životnosti navigátoru měnit, zatímco prochází stejným dokumentem. Význam hodnot musí být také sdílen všemi dvěma navigátory, které jsou v relaci klonování, a to za předpokladu, že stále přecházejí na stejný dokument. Všechny hodnoty dodané get operací musí zůstat platné po dobu života navigátoru a jakékoli jeho klony, pokud instance stále přechází do stejného dokumentu.