XPathNavigator.UnderlyingObject Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 : objPublic Overridable ReadOnly Property UnderlyingObject As ObjectValeur de propriété
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.