XPathNavigator.UnderlyingObject Propriedade

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 Propriedade

A predefinição é null.

Observações

A UnderlyingObject propriedade pode ser usada por XPathNavigator implementações que fornecem uma vista XML "virtualizada" sobre um armazenamento, para dar acesso a objetos subjacentes. Por exemplo, se um XPathNavigator objeto for usado para fornecer uma vista XML virtual sobre um grafo de objeto Common Language Runtime (CLR), pode querer realizar consultas XPath usando o Select método e depois aceder aos objetos CLR subjacentes aos nós selecionados. A UnderlyingObject propriedade exporia esses objetos subjacentes.

Em muitos casos, este valor será null, e o objeto devolvido pela UnderlyingObject propriedade será sempre específico da implementação.

A UnderlyingObject propriedade deve preservar a identidade do objeto e deve ser usada apenas para devolver objetos que tenham correspondência um a um com os respetivos itens sobrepostos. Um utilizador deve sempre obter o mesmo objeto em visitas sucessivas ao mesmo nó usando o mesmo XPathNavigator objeto ou um clonado.