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, setPublic MustOverride Property CurrentPosition As Longプロパティ値
ナビゲーターの現在位置に関連付けられている値。
注釈
set 操作は、指定した値に関連付けられている位置にナビゲーターを移動します。 get 操作は、ナビゲーターの現在位置に関連付けられている値を返します。
注意 (実装者)
このプロパティには、組み込みの意味がありません。 Int64 実装がナビゲーターの現在位置に関連付けている不透明な値です。 値自体についての制限または要件はありません。 内部データ構造に関しては、どのような想定も行うことはできません。
値がシーケンシャルである必要はなく、ナビゲーターの位置が一意の値に対応することさえ必要ではありません。 複数の値が同じナビゲーター位置を参照してもかまわないので、2 つの値を比較しても役に立つ情報は得られません。
get 操作で提供される値は、set 操作に対して有効である必要があります。 先に set 操作で取得したものではない値を get 操作で使用しても、必ずしもエラーになるとは限りません。 CurrentPosition によって返されたものではない、他の方法で取得された値を、実装では有効であると見なしても、見なさなくてもかまいません。どちらにするかは、実装者が選択できます。
値の意味は、ナビゲーターが同じドキュメント内を移動している有効期間の間は不変である必要があります。 また、同じドキュメントを移動している間は、複製によって関連付けられた任意の 2 つのナビゲーターが値の意味を共有する必要があります。 get 操作によって提供されるすべての値は、インスタンスが同じドキュメントを移動している間は、ナビゲーターおよびその複製の有効期間を通じて有効でなければなりません。