SeekableXPathNavigator.CurrentPosition Proprietà

Definizione

Spazio dei nomi:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Quando viene eseguito l'override in una classe derivata, ottiene o imposta un valore associato al nodo dei dati in cui è posizionato il navigatore XPath.

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

Valore della proprietà

Int64

Valore associato alla posizione corrente dello strumento di navigazione.

Commenti

L'operazione set sposta il navigatore nella posizione associata al valore specificato. L'operazione get restituisce un valore associato alla posizione corrente del navigatore.

Note per gli implementatori

Questa proprietà non ha alcun significato intrinseco: è un valore opaco che un'implementazione associa alla posizione corrente Int64 dello strumento di navigazione. Non ci sono restrizioni o requisiti necessari per il valore stesso. Non possono essere fatte supposizioni sulla struttura dei dati interna.

Non è necessario che i valori siano sequenziali o anche che una posizione del navigatore esegua il mapping a un valore univoco. Più valori possono fare riferimento alla stessa posizione del navigatore, quindi il confronto tra i due valori non fornisce informazioni utili.

È necessario che i valori forniti da un'operazione get siano validi per un'operazione set. Non è necessariamente un errore che un'operazione set utilizzi un valore che non è stato prima acquisito da un'operazione get. Un valore non restituito da CurrentPosition acquisito in altri modi non viene necessariamente considerato valido dall'implementazione: la validità dipende dall'implementatore.

Il significato di un valore non deve essere modificato durante la durata del navigatore, mentre si sposta all'interno dello stesso documento. Il significato dei valori deve essere inoltre condiviso da due navigatori correlati dalla clonazione, sempre all'interno di uno stesso documento. Tutti i valori forniti da un'operazione get devono rimanere validi per la durata di un navigatore e di tutti i suoi cloni finché l'istanza si sposta all'interno dello stesso documento.