XPathNavigator.UnderlyingObject Właściwość

Definicja

Przestrzeń nazw:

System.Xml.XPath

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.XPath.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Używane przez XPathNavigator implementacje, które zapewniają "zwirtualizowany" widok XML w magazynie, aby zapewnić dostęp do bazowych obiektów.

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

Wartość właściwości

Object

Wartość domyślna to null.

Uwagi

Właściwość UnderlyingObject może być używana przez XPathNavigator implementacje, które zapewniają "zwirtualizowany" widok XML w magazynie, aby zapewnić dostęp do obiektów bazowych. Jeśli na przykład XPathNavigator obiekt jest używany do zapewnienia wirtualnego widoku XML na grafie obiektów środowiska uruchomieniowego języka wspólnego (CLR), możesz wykonać zapytania XPath przy użyciu Select metody , a następnie uzyskać dostęp do obiektów CLR bazowych dla wybranych węzłów. Właściwość UnderlyingObject uwidacznia te obiekty bazowe.

W wielu przypadkach ta wartość będzie mieć nullwartość , a obiekt zwracany przez UnderlyingObject właściwość będzie zawsze specyficzny dla implementacji.

Właściwość UnderlyingObject powinna zachować tożsamość obiektu i powinna być używana tylko do zwracania obiektów, które mają korespondencję "jeden do jednego" do odpowiednich nadlanych elementów. Użytkownik powinien zawsze uzyskać ten sam obiekt podczas kolejnych wizyt w tym samym węźle przy użyciu tego samego XPathNavigator obiektu lub sklonowanego.

Uwaga

Właściwość UnderlyingObject obiektu utworzonego XPathNavigator XmlDocument przez obiekt zwraca odpowiedni XmlNodeelement .