Compartir a través de


XPathNavigator.UnderlyingObject Propiedad

Definición

Lo utilizan las implementaciones de XPathNavigator que proporcionan una vista XML "virtual" sobre un almacén para proporcionar acceso a los objetos subyacentes.

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

Valor de propiedad

Object

De manera predeterminada, es null.

Comentarios

Las UnderlyingObject implementaciones que proporcionan una vista XML "virtualizada" sobre un almacén pueden usar XPathNavigator la propiedad para proporcionar acceso a los objetos subyacentes. Por ejemplo, si se usa un XPathNavigator objeto para proporcionar una vista XML virtual sobre un gráfico de objetos de Common Language Runtime (CLR), es posible que desee realizar consultas XPath mediante el Select método y, a continuación, obtener acceso a los objetos CLR subyacentes a los nodos seleccionados. La UnderlyingObject propiedad expondría estos objetos subyacentes.

En muchos casos, este valor será nully el objeto devuelto por la propiedad siempre será específico de la UnderlyingObject implementación.

La UnderlyingObject propiedad debe conservar la identidad del objeto y solo debe usarse para devolver objetos que tengan una correspondencia uno a uno con sus respectivos elementos superpuestos. Un usuario siempre debe obtener el mismo objeto en visitas sucesivas al mismo nodo mediante el mismo XPathNavigator objeto o uno clonado.

Nota

La UnderlyingObject propiedad de un XPathNavigator objeto creado por un XmlDocument objeto devuelve el correspondiente XmlNode.

Se aplica a