SeekableXPathNavigator.CurrentPosition Właściwość

Definicja

Przestrzeń nazw:

System.ServiceModel.Dispatcher

Zestaw:

System.ServiceModel.dll

W przypadku przesłonięć w klasie pochodnej program pobiera lub ustawia wartość skojarzoną z węzłem w danych, w których znajduje się nawigator 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

Wartość właściwości

Int64

Wartość skojarzona z bieżącą pozycją nawigatora.

Uwagi

Operacja set przenosi nawigatora do pozycji skojarzonej z określoną wartością. Operacja get zwraca wartość skojarzoną z bieżącym położeniem nawigatora.

Uwagi dotyczące implementowania

Ta właściwość nie ma żadnego wewnętrznego znaczenia: jest nieprzezroczystą wartością, która jest skojarzeń implementacji z bieżącym Int64 położeniem nawigatora. Nie są nakładane żadne ograniczenia ani wymagania dotyczące samej wartości. Nie można mieć żadnych założeń dotyczących wewnętrznej struktury danych.

Nie jest wymagane, aby wartości były sekwencyjne, a nawet że położenie nawigatora jest mapowane na unikatową wartość. Wiele wartości może odwoływać się do tej samej pozycji nawigatora, więc porównanie dwóch wartości nie dostarcza przydatnych informacji.

Każda wartość dostarczana przez get operację musi być prawidłowa dla set operacji. Użycie wartości, która nie została po raz pierwszy pozyskana przez operację, nie musi set być błędem get operacji. Wartość, która nie została zwrócona w inny sposób, może lub może nie zostać uznana za prawidłową przez implementację: ten wybór należy do CurrentPosition osoby wdrażanej.

Znaczenie wartości nie może ulec zmianie w czasie życia nawigatora podczas nawigowania po tym samym dokumencie. Ponadto znaczenie wartości musi być udostępnione przez dwa nawigatory powiązane z klonowaniem, pod warunkiem, że nadal nawigują one po tym samym dokumencie. Wszystkie wartości dostarczone przez operację muszą pozostawać ważne przez cały czas życia nawigatora i wszystkich jego klonów, o ile wystąpienie nadal nawiguje get po tym samym dokumencie.