Freigeben über


XPathNavigator.UnderlyingObject Eigenschaft

Definition

Wird von XPathNavigator-Implementierungen verwendet, die eine "virtualisierte" XML-Ansicht für einen Speicher enthalten, um Zugriff auf zugrunde liegende Objekte zu ermöglichen.

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

Eigenschaftswert

Object

Der Standardwert ist null.

Hinweise

Die UnderlyingObject Eigenschaft kann von XPathNavigator Implementierungen verwendet werden, die eine "virtualisierte" XML-Ansicht über einen Speicher bereitstellen, um Zugriff auf zugrunde liegende Objekte bereitzustellen. Wenn beispielsweise ein XPathNavigator Objekt verwendet wird, um eine virtuelle XML-Ansicht über ein CLR-Objektdiagramm (Common Language Runtime) bereitzustellen, möchten Sie möglicherweise XPath-Abfragen mithilfe der Select Methode ausführen und dann auf die CLR-Objekte zugreifen, die den ausgewählten Knoten zugrunde liegen. Die UnderlyingObject Eigenschaft würde diese zugrunde liegenden Objekte verfügbar machen.

In vielen Fällen wird nulldieser Wert verwendet, und das von der UnderlyingObject Eigenschaft zurückgegebene Objekt ist immer implementierungsspezifisch.

Die UnderlyingObject Eigenschaft sollte die Objektidentität beibehalten und nur verwendet werden, um Objekte zurückzugeben, die eine 1:1-Korrespondenz mit ihren jeweiligen überlagerten Elementen aufweisen. Ein Benutzer sollte immer dasselbe Objekt für aufeinander folgende Besuche auf demselben Knoten mit demselben XPathNavigator Objekt oder einem geklonten Objekt abrufen.

Hinweis

Die UnderlyingObject Eigenschaft eines XPathNavigator Objekts, das von einem XmlDocument Objekt erstellt wurde, gibt den entsprechenden XmlNodeWert zurück.

Gilt für