SeekableXPathNavigator.CurrentPosition 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
當在派生類別中覆寫時,會獲得或設定與 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
屬性值
這個數值與導航員當前的位置相關聯。
備註
操作將 set 導航員移動到與指定值相關的位置。 操作會 get 回傳與導航員當前位置相關的值。
給實施者的注意事項
此屬性本身並無內在意義:它是實作與導航員當前位置關聯的不 Int64 透明值。 對價值本身沒有任何限制或要求。 無法對其內部資料結構做出任何假設。
不要求這些數值是連續的,甚至導航員位置必須對應到唯一值。 多個數值可能指向相同的導航員位置,因此比較兩個數值無法提供有用的資訊。
操作所提供的 get 任何值必須對該 set 操作有效。 操作使用未先由set操作取得的值不一定是錯誤get。 未被 CurrentPosition 回傳且以其他方式取得的值,實作方可能視為有效或不有效:此選擇由實作者決定。
值的意義在其導航員執行同一文件的過程中不得改變。 此外,任何兩位透過複製連結的導航員都必須共享值的意義,前提是他們仍能瀏覽同一份文件。 只要該實例仍在導航同一文件中,所有由 get 操作提供的值必須在導航員及其任何克隆的生命週期內保持有效。