SeekableXPathNavigator.CurrentPosition プロパティ

定義

名前空間:

System.ServiceModel.Dispatcher

アセンブリ:

System.ServiceModel.dll

派生クラスでオーバーライドされると、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

プロパティ値

Int64

ナビゲーターの現在位置に関連付けられている値。

注釈

set 操作は、指定した値に関連付けられている位置にナビゲーターを移動します。 get 操作は、ナビゲーターの現在位置に関連付けられている値を返します。

注意 (実装者)

このプロパティには、組み込みの意味がありません。 Int64 実装がナビゲーターの現在位置に関連付けている不透明な値です。 値自体についての制限または要件はありません。 内部データ構造に関しては、どのような想定も行うことはできません。

値がシーケンシャルである必要はなく、ナビゲーターの位置が一意の値に対応することさえ必要ではありません。 複数の値が同じナビゲーター位置を参照してもかまわないので、2 つの値を比較しても役に立つ情報は得られません。

get 操作で提供される値は、set 操作に対して有効である必要があります。 先に set 操作で取得したものではない値を get 操作で使用しても、必ずしもエラーになるとは限りません。 CurrentPosition によって返されたものではない、他の方法で取得された値を、実装では有効であると見なしても、見なさなくてもかまいません。どちらにするかは、実装者が選択できます。

値の意味は、ナビゲーターが同じドキュメント内を移動している有効期間の間は不変である必要があります。 また、同じドキュメントを移動している間は、複製によって関連付けられた任意の 2 つのナビゲーターが値の意味を共有する必要があります。 get 操作によって提供されるすべての値は、インスタンスが同じドキュメントを移動している間は、ナビゲーターおよびその複製の有効期間を通じて有効でなければなりません。