Condividi tramite


XPathNavigator.UnderlyingObject Proprietà

Definizione

Utilizzato dalle implementazioni di XPathNavigator che forniscono una visualizzazione XML "virtuale" di un archivio per consentire l'accesso agli oggetti sottostanti.

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

Valore della proprietà

Object

Il valore predefinito è null.

Commenti

La UnderlyingObject proprietà può essere utilizzata dalle XPathNavigator implementazioni che forniscono una visualizzazione XML "virtualizzata" su un archivio, per fornire l'accesso agli oggetti sottostanti. Ad esempio, se XPathNavigator un oggetto viene usato per fornire una visualizzazione XML virtuale su un oggetto grafico di Common Language Runtime (CLR), è possibile eseguire query XPath usando il Select metodo e quindi accedere agli oggetti CLR sottostanti i nodi selezionati. La UnderlyingObject proprietà espone questi oggetti sottostanti.

In molti casi, questo valore sarà nulle l'oggetto restituito dalla UnderlyingObject proprietà sarà sempre specifico dell'implementazione.

La UnderlyingObject proprietà deve mantenere l'identità dell'oggetto e deve essere utilizzata solo per restituire oggetti con una corrispondenza uno-a-uno ai rispettivi elementi sovrapposti. Un utente deve sempre ottenere lo stesso oggetto nelle visite successive allo stesso nodo usando lo stesso XPathNavigator oggetto o uno clonato.

Nota

La UnderlyingObject proprietà di un XPathNavigator oggetto creato da un XmlDocument oggetto restituisce l'oggetto corrispondente XmlNode.

Si applica a