XPathNavigator.UnderlyingObject Propriété

Définition

Espace de noms:

System.Xml.XPath

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.XPath.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Utilisé par les implémentations de XPathNavigator qui fournissent un affichage XML « virtualisé » d'un magasin, en vue de proposer un accès aux objets sous-jacents.

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

Valeur de propriété

Object

La valeur par défaut est null.

Remarques

La UnderlyingObject propriété peut être utilisée par XPathNavigator des implémentations qui fournissent une vue XML « virtualisée » sur un magasin, pour fournir l’accès aux objets sous-jacents. Par exemple, si un XPathNavigator objet est utilisé pour fournir une vue XML virtuelle sur un graphique d’objets CLR (Common Language Runtime), vous pouvez effectuer des requêtes XPath à l’aide de la Select méthode, puis accéder aux objets CLR sous-jacents aux nœuds sélectionnés. La UnderlyingObject propriété expose ces objets sous-jacents.

Dans de nombreux cas, cette valeur sera null, et l’objet retourné par la propriété sera toujours spécifique à l’implémentation UnderlyingObject .

La UnderlyingObject propriété doit conserver l’identité de l’objet et ne doit être utilisée que pour renvoyer des objets ayant une correspondance un-à-un à leurs éléments superposés respectifs. Un utilisateur doit toujours obtenir le même objet sur les visites successives au même nœud à l’aide du même XPathNavigator objet ou d’un objet cloné.

Notes

La UnderlyingObject propriété d’un XPathNavigator objet créé par un XmlDocument objet retourne le fichier correspondant XmlNode.