XPathNavigator.UnderlyingObject Propriedade

Definição

Namespace:

System.Xml.XPath

Assemblies:

netstandard.dll, System.Xml.ReaderWriter.dll

Origem:

XPathNavigator.cs

Usado por XPathNavigator implementações que fornecem uma exibição XML "virtualizada" em um repositório, para fornecer acesso a objetos subjacentes.

public:
 virtual property System::Object ^ UnderlyingObject { System::Object ^ 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ê queira 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 de implementação.

A UnderlyingObject propriedade deve preservar a identidade do objeto e deve ser usada apenas para retornar objetos que tenham uma correspondência um-para-um para seus respectivos itens sobrepostos. Um usuário sempre deve 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.