XPathNavigator.UnderlyingObject Propriedade

Definição

Namespace:

System.Xml.XPath

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.XPath.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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 : obj

Public Overridable ReadOnly Property UnderlyingObject As Object

Valor da propriedade

Object

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.