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.
Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird ein Wert abgerufen oder festgelegt, der dem Knoten in den Daten zugeordnet ist, in denen der XPath-Navigator positioniert ist.
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 Wert zurück, der der aktuellen Position des Navigators zugeordnet ist.
Hinweise für Ausführende
Diese Eigenschaft hat keine systeminterne Bedeutung: Es handelt sich um einen undurchsichtigen Int64 Wert, den eine Implementierung der aktuellen Position des Navigators zuordnet. Für den Wert selbst gelten keine Einschränkungen oder Anforderungen. Es können keine Annahmen über die interne Datenstruktur gemacht werden.
Es ist nicht erforderlich, dass die Werte sequenziell oder sogar eine Navigatorposition einem eindeutigen Wert zugeordnet sind. Mehrere Werte können auf dieselbe Navigatorposition verweisen, sodass beim Vergleichen zweier Werte keine nützlichen Informationen bereitgestellt werden.
Jeder von einem get Vorgang bereitgestellte Wert muss für einen set Vorgang gültig sein. Es ist nicht notwendigerweise ein Fehler für einen set Vorgang, um einen Wert zu verwenden, der nicht zuerst von einem get Vorgang abgerufen wurde. Ein Wert, der nicht von CurrentPosition diesem zurückgegeben wurde, kann oder wird von der Implementierung möglicherweise als gültig angesehen: Diese Auswahl liegt bei der Implementierung.
Die Bedeutung eines Werts darf sich während der Lebensdauer seines Navigators nicht ändern, während es im selben Dokument navigiert. Außerdem muss die Bedeutung von Werten von zwei Navigatoren geteilt werden, die durch Klonen miteinander verbunden sind, vorausgesetzt, sie navigieren weiterhin im selben Dokument. Alle von einem get Vorgang bereitgestellten Werte müssen für die Lebensdauer eines Navigators und eines seiner Klonen gültig bleiben, solange die Instanz weiterhin im selben Dokument navigiert.
