XPathNavigator.UnderlyingObject Egenskap

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

Egenskapsvärde

Standardvärdet är null.

Kommentarer

Egenskapen UnderlyingObject kan användas av XPathNavigator implementeringar som ger en "virtualiserad" XML-vy över ett arkiv för att ge åtkomst till underliggande objekt. Om ett XPathNavigator objekt till exempel används för att tillhandahålla en virtuell XML-vy över ett CLR-objektdiagram (Common Language Runtime) kanske du vill köra XPath-frågor med hjälp av Select metoden och sedan komma åt CLR-objekten som ligger bakom de valda noderna. Egenskapen UnderlyingObject skulle exponera dessa underliggande objekt.

I många fall blir nulldet här värdet , och objektet som returneras av UnderlyingObject egenskapen är alltid implementeringsspecifikt.

Egenskapen UnderlyingObject ska bevara objektidentiteten och bör endast användas för att returnera objekt som har en en-till-en-korrespondens till sina respektive överlagrade objekt. En användare bör alltid få samma objekt vid efterföljande besök på samma nod med samma XPathNavigator objekt eller ett klonat objekt.