XPathNavigator.UnderlyingObject Eigenschaft

Definition

Namespace:

System.Xml.XPath

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XPathNavigator.cs

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

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

Eigenschaftswert

Object

Der Standardwert lautet 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 zu ermöglichen. Wenn z. B. ein XPathNavigator Objekt verwendet wird, um eine virtuelle XML-Ansicht über ein CLR-Objektdiagramm (Common Language Runtime) bereitzustellen, können Sie 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 ist nulldieser Wert , 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 bei aufeinanderfolgenden Aufrufen desselben Knotens mit demselben XPathNavigator Objekt oder einem geklonten Objekt abrufen.

Hinweis

Die UnderlyingObject Eigenschaft eines XPathNavigator von einem XmlDocument Objekt erstellten Objekts gibt die entsprechende XmlNodezurück.