SeekableXPathNavigator.CurrentPosition Eigenschap

Definitie

Wanneer deze wordt overschreven in een afgeleide klasse, haalt of stelt u een waarde in die is gekoppeld aan het knooppunt in de gegevens waarin de XPath-navigator wordt weergegeven.

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

Waarde van eigenschap

Een waarde die is gekoppeld aan de huidige positie van de navigator.

Opmerkingen

Met set de bewerking wordt de navigator verplaatst naar de positie die is gekoppeld aan de opgegeven waarde. De get bewerking retourneert een waarde die is gekoppeld aan de huidige positie van de navigator.

Notities voor uitvoerders

Deze eigenschap heeft geen intrinsieke betekenis: het is een ondoorzichtige Int64 waarde die een implementatie koppelt aan de huidige positie van de navigator. Er worden geen beperkingen of vereisten op de waarde zelf geplaatst. Er kunnen geen veronderstellingen over de interne gegevensstructuur worden gemaakt.

Het is niet vereist dat de waarden opeenvolgend zijn of zelfs dat een navigatorpositie is toegewezen aan een unieke waarde. Meerdere waarden kunnen verwijzen naar dezelfde navigatorpositie, dus het vergelijken van twee waarden biedt geen nuttige informatie.

Elke waarde die door een get bewerking wordt opgegeven, moet geldig zijn voor een set bewerking. Het is niet noodzakelijkerwijs een fout voor een set bewerking om een waarde te gebruiken die niet eerst door een get bewerking is verkregen. Een waarde die niet is geretourneerd door CurrentPosition die is verkregen, kan of niet als geldig worden beschouwd door de implementatie: deze keuze is aan de implementeerfunctie.

De betekenis van een waarde mag niet veranderen tijdens de levensduur van de navigator terwijl deze door hetzelfde document navigeert. Ook moet de betekenis van waarden worden gedeeld door twee navigators die zijn gerelateerd door klonen, opnieuw, mits ze nog steeds door hetzelfde document navigeren. Alle waarden die door een get bewerking worden opgegeven, moeten geldig blijven gedurende de levensduur van een navigator en alle bijbehorende klonen zolang het exemplaar nog steeds door hetzelfde document navigeert.

Van toepassing op