XPathNavigator.UnderlyingObject Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Usado por implementações de XPathNavigator que fornecem uma exibição XML "virtualizada" sobre um repositório, a fim de fornecer acesso aos objetos subjacentes.
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 da propriedade
O padrão é null.
Comentários
A UnderlyingObject propriedade pode ser usada por XPathNavigator implementações que fornecem uma exibição XML "virtualizada" em um repositório, para fornecer acesso a objetos subjacentes. Por exemplo, se um XPathNavigator objeto for usado para fornecer uma exibição XML virtual em um grafo de objeto CLR (Common Language Runtime), talvez você deseje executar consultas XPath usando o Select método e, em seguida, acessar os objetos CLR subjacentes aos nós selecionados. A UnderlyingObject propriedade exporia esses objetos subjacentes.
Em muitos casos, esse valor será null, e o objeto retornado pela UnderlyingObject propriedade sempre será específico da implementação.
A UnderlyingObject propriedade deve preservar a identidade do objeto e só deve ser usada para retornar objetos que tenham uma correspondência um-para-um para seus respectivos itens sobrepostos. Um usuário deve sempre obter o mesmo objeto em visitas sucessivas ao mesmo nó usando o mesmo XPathNavigator objeto ou um clonado.
Observação
A UnderlyingObject propriedade de um XPathNavigator objeto criado por um XmlDocument objeto retorna o correspondente XmlNode.