XPathNavigator.UnderlyingObject Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 : objPublic Overridable ReadOnly Property UnderlyingObject As ObjectEigenschaftswert
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.