XPathNavigator.UnderlyingObject Eigenschap

Definitie

Naamruimte:

System.Xml.XPath

Assembly's:

netstandard.dll, System.Xml.ReaderWriter.dll

Bron:

XPathNavigator.cs

Wordt gebruikt door XPathNavigator implementaties die een 'gevirtualiseerde' XML-weergave bieden over een archief, om toegang te bieden tot onderliggende objecten.

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

Waarde van eigenschap

Object

De standaardwaarde is null.

Opmerkingen

De UnderlyingObject eigenschap kan worden gebruikt door XPathNavigator implementaties die een 'gevirtualiseerde' XML-weergave over een archief bieden om toegang te bieden tot onderliggende objecten. Als een XPathNavigator object bijvoorbeeld wordt gebruikt om een virtuele XML-weergave te bieden via een CLR-objectgrafiek (Common Language Runtime), kunt u XPath-query's uitvoeren met behulp van de Select methode en vervolgens toegang krijgen tot de CLR-objecten onder de geselecteerde knooppunten. Met de UnderlyingObject eigenschap worden deze onderliggende objecten weergegeven.

In veel gevallen is nulldeze waarde en het object dat door de UnderlyingObject eigenschap wordt geretourneerd, is altijd specifiek voor de implementatie.

De UnderlyingObject eigenschap moet de objectidentiteit behouden en mag alleen worden gebruikt om objecten te retourneren die een een-op-een-correspondentie hebben met hun respectieve overlappende items. Een gebruiker moet altijd hetzelfde object krijgen bij opeenvolgende bezoeken aan hetzelfde knooppunt met hetzelfde XPathNavigator object of een gekloonde.

Note

De UnderlyingObject eigenschap van een XPathNavigator object dat door een XmlDocument object is gemaakt, retourneert de bijbehorende XmlNode.