SeekableXPathNavigator.CurrentPosition Propriété

Définition

Espace de noms:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

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, set

Public MustOverride Property CurrentPosition As Long

Valeur de propriété

Int64

Valeur associée à la position actuelle du navigateur.

Remarques

L'opération set déplace le navigateur à 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 Int64 valeur opaque qu’une implémentation associe à la position actuelle du navigateur. Aucune restriction ou exigence n’est placée sur la valeur elle-même. Aucune hypothèse sur sa structure de données interne ne peut être effectuée.

Les valeurs ne doivent pas nécessairement être séquentielles ou une position de navigateur ne doit pas nécessairement correspondre à une valeur unique. Plusieurs valeurs peuvent faire référence à la même position de navigateur. La comparaison de deux valeurs ne fournit donc pas d'informations utiles.

Toute valeur fournie par une opération get doit être valide pour une opération set. L'utilisation d'une valeur qui n'a pas d'abord été acquise par une opération set pour une opération get ne représente pas nécessairement une erreur. Une valeur non retournée par CurrentPosition qui a été acquise d'une autre façon peut ou non être considérée comme valide par l'implémentation : ce choix revient à l'implémenteur.

La signification d'une valeur ne doit pas changer au cours de la vie de son navigateur pendant qu'il navigue le même document. De même, la signification de valeurs doit être partagée par tous les couples de navigateurs liés par clonage, de nouveau, à condition qu'ils naviguent encore le même document. Toutes les valeurs fournies par une opération get doivent rester valides au cours de la vie d'un navigateur et de chacun de ses clones tant que l'instance navigue encore le même document.