SeekableXPathNavigator.CurrentPosition Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
In caso di override in una classe derivata, ottiene o imposta un valore associato al nodo nei dati in cui è posizionato lo strumento di navigazione XPath.
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 LongValore della proprietà
Valore associato alla posizione corrente dello strumento di navigazione.
Commenti
L'operazione set sposta lo strumento di navigazione nella posizione associata al valore specificato. L'operazione get restituisce un valore associato alla posizione corrente dello strumento di navigazione.
Note per gli implementatori
Questa proprietà non ha alcun significato intrinseco: si tratta di un valore opaco Int64 associato da un'implementazione alla posizione corrente dello strumento di navigazione. Non vengono applicate restrizioni o requisiti al valore stesso. Non è possibile fare ipotesi sulla struttura dei dati interna.
Non è necessario che i valori siano sequenziali o anche che una posizione dello strumento di navigazione sia mappata a un valore univoco. Più valori possono fare riferimento alla stessa posizione dello strumento di navigazione, quindi il confronto di due valori non fornisce informazioni utili.
Qualsiasi valore fornito da un'operazione get deve essere valido per un'operazione set . Non è necessariamente un errore per un'operazione set di utilizzare un valore non acquisito prima da un'operazione get . Un valore non restituito da CurrentPosition che è stato acquisito in altro modo può essere considerato valido dall'implementazione: questa scelta spetta all'implementatore.
Il significato di un valore non deve cambiare durante la durata dello strumento di spostamento mentre si sposta nello stesso documento. Inoltre, il significato dei valori deve essere condiviso da due strumenti di spostamento correlati clonando, anche in questo caso, purché continuino a spostarsi nello stesso documento. Tutti i valori forniti da un'operazione get devono rimanere validi per la durata di uno strumento di navigazione e i relativi cloni, purché l'istanza continui a spostarsi nello stesso documento.
