SeekableXPathNavigator.CurrentPosition Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
När det åsidosätts i en härledd klass hämtar eller anger du ett värde som är associerat med noden i de data där XPath-navigatören är placerad.
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 LongEgenskapsvärde
Ett värde som är associerat med navigatörens aktuella position.
Kommentarer
Åtgärden set flyttar navigatören till den position som är associerad med det angivna värdet. Åtgärden get returnerar ett värde som är associerat med navigatörens aktuella position.
Anteckningar till implementerare
Den här egenskapen har ingen inbyggd betydelse: det är ett täckande Int64 värde som en implementering associerar med navigatörens aktuella position. Inga begränsningar eller krav ställs på själva värdet. Det går inte att göra några antaganden om dess interna datastruktur.
Det krävs inte att värdena är sekventiella, eller ens att en navigatör position mappas till ett unikt värde. Flera värden kan referera till samma navigatörsposition, så att jämföra två värden ger inte användbar information.
Alla värden som tillhandahålls av en get åtgärd måste vara giltiga för en set åtgärd. Det är inte nödvändigtvis ett fel för en set åtgärd att använda ett värde som inte först har hämtats av en get åtgärd. Ett värde som inte returneras av CurrentPosition som har förvärvats på något annat sätt kan eller kanske inte anses giltigt av implementeringen: det här valet är upp till implementeraren.
Innebörden av ett värde får inte ändras under navigatörens livslängd medan det navigerar i samma dokument. Dessutom måste innebörden av värden delas av två navigatörer som är relaterade genom kloning, igen, förutsatt att de fortfarande navigerar i samma dokument. Alla värden som tillhandahålls av en get åtgärd måste vara giltiga under en navigatörs livslängd och någon av dess kloner så länge instansen fortfarande navigerar i samma dokument.
