SeekableXPathNavigator.CurrentPosition Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft beim Überschreiben in einer abgeleiteten Klasse einen Wert ab, der dem Knoten in den Daten, an dem der XPath-Navigator positioniert ist, zugeordnet ist, bzw. legt einen solchen Wert fest.
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 LongEigenschaftswert
Ein -Wert, der der aktuellen Position des Navigators zugeordnet ist.
Hinweise
Der set-Vorgang verschiebt den Navigator an die Position, die dem angegebenen Wert zugeordnet ist. Der get-Vorgang gibt einen der aktuellen Position des Navigators zugeordneten Wert zurück.
Hinweise für Ausführende
Diese Eigenschaft hat keine intrinsische Bedeutung: Es handelt sich um einen nicht transparenten Wert, den eine Implementierung der aktuellen Position Int64 des Navigators zu ordnet. Für den Wert selbst gelten keine Beschränkungen oder Anforderungen. Es können keine Annahmen über seine interne Datenstruktur gemacht werden.
Es ist nicht erforderlich, dass die Werte sequenziell sind oder dass einer Navigatorposition ein eindeutiger Wert zugewiesen ist. Mehrere Werte können auf dieselbe Navigatorposition verweisen. Das Vergleichen von zwei Werten liefert daher keine sinnvollen Informationen.
Jeder Wert, den ein get-Vorgang liefert, muss für einen set-Vorgang gültig sein. Es ist nicht unbedingt ein Fehler, wenn ein set-Vorgang einen Wert verwendet, der nicht zunächst durch einen get-Vorgang abgerufen wurde. Ein Wert, der nicht von CurrentPosition zurückgegeben wurde und in anderer Weise abgerufen wurde, kann durch die Implementierung als gültig betrachtet werden: Diese Entscheidung wird vom Implementierer getroffen.
Die Bedeutung eines Werts darf sich während der Lebensdauer seines Navigators beim Navigieren im selben Dokument nicht ändern. Auch muss die Bedeutung der Werte für zwei durch Klonen miteinander in Beziehung stehende Navigatoren gleich sein, wenn diese weiterhin im selben Dokument navigieren. Alle von einem get-Vorgang gelieferten Werte müssen während der Lebensdauer eines Navigators und seiner Klone gültig bleiben, solange die Instanz weiterhin im selben Dokument navigiert.