XPathNavigator.UnderlyingObject Свойство

Определение

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

System.Xml.XPath

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.XPath.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

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

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

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

Object

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

Комментарии

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

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

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

Примечание

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