SeekableXPathNavigator.CurrentPosition Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
En cas de substitution dans une classe dérivée, obtient ou définit une valeur associée au nœud dans les données où le navigateur XPath est positionné.
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 LongValeur de propriété
Valeur associée à la position actuelle du navigateur.
Remarques
L’opération set déplace le navigateur vers la position associée à la valeur spécifiée. L’opération get retourne une valeur associée à la position actuelle du navigateur.
Notes pour les responsables de l’implémentation
Cette propriété n’a aucune signification intrinsèque : il s’agit d’une valeur opaque Int64 qu’une implémentation associe à la position actuelle du navigateur. Aucune restriction ni aucune exigence n’est placée sur la valeur elle-même. Aucune hypothèse concernant sa structure de données interne ne peut être effectuée.
Il n’est pas nécessaire que les valeurs soient séquentielles, ou même qu’un mappage de position de navigateur à une valeur unique. Plusieurs valeurs peuvent faire référence à la même position de navigateur. Par conséquent, la comparaison de deux valeurs ne fournit pas d’informations utiles.
Toute valeur fournie par une get opération doit être valide pour une set opération. Il ne s’agit pas nécessairement d’une erreur pour une set opération d’utiliser une valeur qui n’est pas acquise d’abord par une get opération. Une valeur non retournée par CurrentPosition ce qui a été acquise d’une autre façon peut ou non être considérée comme valide par l’implémentation : ce choix est à la hauteur de l’implémenteur.
La signification d’une valeur ne doit pas changer pendant la durée de vie de son navigateur pendant qu’elle navigue dans le même document. En outre, la signification des valeurs doit être partagée par deux navigateurs qui sont liés par clonage, à nouveau, à condition qu’elles naviguent toujours dans le même document. Toutes les valeurs fournies par une get opération doivent rester valides pour la durée de vie d’un navigateur et de l’un de ses clones tant que l’instance navigue toujours dans le même document.
