XPathNavigator.UnderlyingObject Свойство

Определение

Пространство имен:

System.Xml.XPath

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XPathNavigator.cs

XPathNavigator Используется реализациями, предоставляя "виртуализированное" представление XML в хранилище для предоставления доступа к базовым объектам.

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

Значение свойства

Object

Значение по умолчанию — null.

Комментарии

Это UnderlyingObject свойство можно использовать XPathNavigator реализацией, которые предоставляют представление XML виртуализированного XML-файла в хранилище для предоставления доступа к базовым объектам. Например, если XPathNavigator объект используется для предоставления виртуального XML-представления по графу объектов среды CLR, может потребоваться выполнить запросы XPath с помощью Select метода, а затем получить доступ к объектам СРЕДЫ CLR, лежащим в основе выбранных узлов. Свойство будет предоставлять эти базовые UnderlyingObject объекты.

Во многих случаях это значение будет nullиметь значение, и объект, возвращаемый UnderlyingObject свойством, всегда будет конкретным в реализации.

Свойство UnderlyingObject должно сохранять удостоверение объекта и использовать только для возврата объектов, имеющих одно-одно соответствие с соответствующими наложенными элементами. Пользователь всегда должен получать один и тот же объект при последующих посещениях одного узла, используя тот же XPathNavigator объект или клонированную.

Замечание

Свойство UnderlyingObject объекта, созданного XPathNavigator объектом, XmlDocument возвращает соответствующее XmlNode.