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.
Usato dalle XPathNavigator implementazioni che forniscono una visualizzazione XML "virtualizzata" su un archivio, per fornire 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 un XPathNavigator oggetto viene usato per fornire una visualizzazione XML virtuale su un oggetto grafico a oggetti CLR (Common Language Runtime), è 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 proprietà sarà sempre specifico dell'implementazione UnderlyingObject .
La UnderlyingObject proprietà deve mantenere l'identità dell'oggetto e deve essere utilizzata solo per restituire oggetti con 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.
Annotazioni
La UnderlyingObject proprietà di un oggetto creato da un XmlDocumentXPathNavigator oggetto restituisce l'oggetto corrispondenteXmlNode.
