SeekableXPathNavigator.CurrentPosition Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Po zastąpieniu w klasie pochodnej 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, setPublic MustOverride Property CurrentPosition As LongWartość właściwości
Wartość skojarzona z bieżącym położeniem 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.
Notatki dotyczące implementowania
Ta właściwość nie ma żadnego znaczenia wewnętrznego: jest nieprzezroczystą Int64 wartością skojarzoną z bieżącą pozycją nawigatora. Żadne ograniczenia ani wymagania nie są nakładane na samą wartość. Nie można założyć żadnych założeń dotyczących wewnętrznej struktury danych.
Nie jest wymagane, aby wartości są sekwencyjne, a nawet że pozycja nawigatora jest mapowania na unikatową wartość. Wiele wartości może odwoływać się do tej samej pozycji nawigatora, dlatego porównanie dwóch wartości nie zapewnia przydatnych informacji.
Każda wartość dostarczana przez operację get musi być prawidłowa set dla operacji. Niekoniecznie jest to błąd operacji set , aby użyć wartości, która nie została najpierw uzyskana przez operację get . Wartość, która nie została zwrócona w CurrentPosition inny sposób, może lub nie może być uważana za prawidłową przez implementację: ten wybór jest do implementatora.
Znaczenie wartości nie może zmieniać się podczas życia nawigatora podczas nawigowania po tym samym dokumencie. Ponadto znaczenie wartości musi być współużytkowane przez dwa nawigatory, które są powiązane przez klonowanie, ponownie, pod warunkiem, że nadal nawigują po tym samym dokumencie. Wszystkie wartości dostarczone przez operację get muszą pozostać prawidłowe dla okresu istnienia nawigatora i dowolnego z jego klonów, o ile wystąpienie nadal przechodzi do tego samego dokumentu.
