XPathNavigator.UnderlyingObject 属性
定义
由在存储区上提供“虚拟化”XML 视图的 XPathNavigator 实现使用,以提供对基础对象的访问。Used by XPathNavigator implementations which provide a "virtualized" XML view over a store, to provide access to underlying objects.
public:
virtual property System::Object ^ UnderlyingObject { System::Object ^ get(); };
public virtual object? UnderlyingObject { get; }
public virtual object UnderlyingObject { get; }
member this.UnderlyingObject : obj
Public Overridable ReadOnly Property UnderlyingObject As Object
属性值
默认值为 null。The default is null.
注解
此 UnderlyingObject 属性可由在 XPathNavigator 存储区上提供 "虚拟化" XML 视图的实现使用,以提供对基础对象的访问。The UnderlyingObject property can be used by XPathNavigator implementations which provide a "virtualized" XML view over a store, to provide access to underlying objects. 例如,如果某个 XPathNavigator 对象用于通过公共语言运行时 (CLR) 对象图提供虚拟 XML 视图,则可能需要使用方法执行 XPath 查询, Select 然后访问所选节点下的 CLR 对象。For example, if an XPathNavigator object is used to provide a virtual XML view over a Common Language Runtime (CLR) object graph, you may wish to perform XPath queries using the Select method and then access the CLR objects underlying the selected nodes. UnderlyingObject属性将公开这些基础对象。The UnderlyingObject property would expose these underlying objects.
在许多情况下,此值将为 null ,并且属性返回的对象 UnderlyingObject 将始终为实现特定的。In many cases, this value will be null, and the object returned by the UnderlyingObject property will always be implementation specific.
UnderlyingObject属性应保留对象标识,只应用于返回与各自的重叠项具有一对一对应关系的对象。The UnderlyingObject property should preserve object identity and should only be used to return objects that have a one-to-one correspondence to their respective overlaid items. 用户应始终使用同一对象或克隆的对象,在对同一节点的连续访问上获得相同的对象 XPathNavigator 。A user should always get the same object on successive visits to the same node using the same XPathNavigator object or a cloned one.
备注
UnderlyingObject XPathNavigator 对象创建的对象的属性 XmlDocument 返回相应的 XmlNode 。The UnderlyingObject property of an XPathNavigator object created by an XmlDocument object returns the corresponding XmlNode.