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 値です。 値自体に制限や要件は適用されません。 内部データ構造に関する想定は行われません。
値をシーケンシャルにしたり、ナビゲーターの位置を一意の値にマップしたりする必要はありません。 複数の値が同じナビゲーター位置を参照できるため、2 つの値を比較しても役立つ情報は得られない。
get操作によって指定されるすべての値は、set操作に対して有効である必要があります。
get操作によって最初に取得されていない値をset操作で使用することは、必ずしもエラーであるとは限りません。 何らかの方法で取得された CurrentPosition によって返されない値は、実装によって有効と見なされる場合もあれば、有効でない場合もあります。この選択は実装者にかかっています。
値の意味は、ナビゲーターが同じドキュメント内を移動する間、そのナビゲーターの有効期間中に変更してはなりません。 また、値の意味は、複製によって関連する 2 つのナビゲーターによって共有される必要があります(同じドキュメント内を移動する場合)。
get操作によって提供されるすべての値は、インスタンスが同じドキュメント内を移動する限り、ナビゲーターとその複製の有効期間中は有効なままである必要があります。