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
作業提供的所有值在導覽及其任何複製項的存留期限內一定會保持有效。