XPathNavigator.UnderlyingObject Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 : objPublic Overridable ReadOnly Property UnderlyingObject As ObjectValor de propiedad
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.