XPathNavigator.UnderlyingObject Propriedade

Definição

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.Used by XPathNavigator implementations which provide a "virtualized" XML view over a store, to provide access to underlying objects.

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.The default is 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 aos objetos subjacentes.The UnderlyingObject property can be used by XPathNavigator implementations which provide a "virtualized" XML view over a store, to provide access to underlying objects. Por exemplo, se um XPathNavigator objeto for usado para fornecer uma exibição XML virtual em um gráfico 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.For example, if an XPathNavigator object is used to provide a virtual XML view over a Common Language Runtime (CLR) object graph, you may wish to perform XPath queries using the Select method and then access the CLR objects underlying the selected nodes. A UnderlyingObject propriedade deve expor esses objetos subjacentes.The UnderlyingObject property would expose these underlying objects.

Em muitos casos, esse valor será null , e o objeto retornado pela UnderlyingObject propriedade sempre será específico da implementação.In many cases, this value will be null, and the object returned by the UnderlyingObject property will always be implementation specific.

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.The UnderlyingObject property should preserve object identity and should only be used to return objects that have a one-to-one correspondence to their respective overlaid items. Um usuário sempre deve obter o mesmo objeto em visitas sucessivas ao mesmo nó usando o mesmo XPathNavigator objeto ou um clonado.A user should always get the same object on successive visits to the same node using the same XPathNavigator object or a cloned one.

Observação

A UnderlyingObject propriedade de um XPathNavigator objeto criado por um XmlDocument objeto retorna o correspondente XmlNode .The UnderlyingObject property of an XPathNavigator object created by an XmlDocument object returns the corresponding XmlNode.

Aplica-se a