XPathNavigator.UnderlyingObject Vlastnost

Definice

Používá XPathNavigator implementace, které poskytují "virtualizované" zobrazení XML přes úložiště, aby poskytovaly přístup k podkladovým objektům.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

Hodnota vlastnosti

Object

Výchozí formát je null.The default is null.

Poznámky

UnderlyingObjectVlastnost může být použita XPathNavigator implementacemi, které poskytují "virtualizované" zobrazení XML přes úložiště, aby byl zajištěn přístup k podkladovým objektům.The UnderlyingObject property can be used by XPathNavigator implementations which provide a "virtualized" XML view over a store, to provide access to underlying objects. Například pokud XPathNavigator je objekt použit k poskytnutí zobrazení Virtual XML přes graf objektu modulu CLR (Common Language Runtime), můžete chtít provádět dotazy XPath pomocí Select metody a pak přistupovat k OBJEKTům CLR podkladovým vybraným uzlům.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. UnderlyingObjectVlastnost by zveřejnila tyto základní objekty.The UnderlyingObject property would expose these underlying objects.

V mnoha případech bude tato hodnota null a objekt vrácený UnderlyingObject vlastností bude vždy specifický pro implementaci.In many cases, this value will be null, and the object returned by the UnderlyingObject property will always be implementation specific.

UnderlyingObjectVlastnost by měla zachovat identitu objektu a měla by být použita pouze k vrácení objektů, které mají korespondenci 1:1 na jejich příslušné překryté položky.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. Uživatel by měl vždy získat stejný objekt při následných návštěvách do stejného uzlu pomocí stejného XPathNavigator objektu nebo naklonovaného.A user should always get the same object on successive visits to the same node using the same XPathNavigator object or a cloned one.

Poznámka

UnderlyingObjectVlastnost XPathNavigator objektu vytvořeného XmlDocument objektem vrací odpovídající XmlNode .The UnderlyingObject property of an XPathNavigator object created by an XmlDocument object returns the corresponding XmlNode.

Platí pro