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.

Note

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