SeekableXPathNavigator.CurrentPosition プロパティ

定義

派生クラスでオーバーライドされると、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操作によって提供されるすべての値は、インスタンスが同じドキュメント内を移動する限り、ナビゲーターとその複製の有効期間中は有効なままである必要があります。

適用対象