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
操作提供的所有值必须在导航器及其所有复本的生存期内保持有效,前提是实例仍在同一文档中导航。