XPathNavigator.UnderlyingObject Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 : objPublic Overridable ReadOnly Property UnderlyingObject As ObjectValore della proprietà
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.