XPathNavigator.UnderlyingObject Vlastnost

Definice

Obor názvů:

System.Xml.XPath

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.XPath.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

Používá se při XPathNavigator implementacích, které poskytují "virtualizované" zobrazení XML v úložišti, aby bylo možné poskytnout přístup k podkladovým objektům.

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.

Poznámky

Vlastnost UnderlyingObject lze použít XPathNavigator implementacemi, které poskytují "virtualizované" zobrazení XML v úložišti, k poskytnutí přístupu k podkladovým objektům. Pokud XPathNavigator se například objekt používá k poskytnutí virtuálního zobrazení XML v grafu objektů CLR (Common Language Runtime), můžete pomocí metody provést dotazy Select XPath a pak získat přístup k objektům CLR podkladovým vybraným uzlům. Vlastnost UnderlyingObject by zpřístupnila tyto podkladové objekty.

V mnoha případech bude tato hodnota nulla objekt vrácený UnderlyingObject vlastností bude vždy implementace specifická.

Vlastnost UnderlyingObject by měla zachovat identitu objektu a měla by se použít 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.