XPathNavigator.UnderlyingObject Vlastnost

Definice

Obor názvů:

System.Xml.XPath

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XPathNavigator.cs

Používá se v XPathNavigator implementacích, které poskytují "virtualizované" zobrazení XML v úložišti, k zajištění přístupu k podkladovým objektům.

public:
 virtual property System::Object ^ UnderlyingObject { System::Object ^ get(); };

public virtual object? UnderlyingObject { get; }

member this.UnderlyingObject : obj

Public Overridable ReadOnly Property UnderlyingObject As Object

Hodnota vlastnosti

Object

Výchozí hodnota je null.

Poznámky

Vlastnost UnderlyingObject lze použít implementace XPathNavigator , které poskytují "virtualizované" zobrazení XML v úložišti, k zajištění přístupu k podkladovým objektům. Pokud XPathNavigator se například objekt používá k poskytnutí virtuálního zobrazení XML přes graf objektů CLR (Common Language Runtime), můžete chtít pomocí metody provádět dotazy Select XPath a pak přistupovat k objektům CLR, které jsou základem vybraných uzlů. Vlastnost UnderlyingObject by tyto podkladové objekty zpřístupnila.

V mnoha případech bude nulltato hodnota a objekt vrácený UnderlyingObject vlastností bude vždy specifické pro implementaci.

Vlastnost UnderlyingObject by měla zachovat identitu objektu a měla by být použita pouze k vrácení objektů, které mají korespondenci 1:1 s příslušnými překryvné položky. Uživatel by měl vždy získat stejný objekt při následných návštěvách stejného uzlu pomocí stejného XPathNavigator objektu nebo klonovaného objektu.

Poznámka:

Vlastnost UnderlyingObject objektu XPathNavigator vytvořeného objektem XmlDocument vrátí odpovídající XmlNode.