Xml.XMLIntf.IXMLNode.ChildValues

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property ChildValues[const IndexOrName: OleVariant]: OleVariant read GetChildValue write SetChildValue; default;

C++

__property System::OleVariant ChildValues[const System::OleVariant IndexOrName] = {read=GetChildValue, write=SetChildValue/*, default*/};

Propriétés

Type Visibilité  Source Unité  Parent
property public
Xml.XMLIntf.pas
Xml.XMLIntf.hpp
Xml.XMLIntf IXMLNode

Description

Représente les valeurs des noeuds enfant de ce noeud.

ChildValues permet d'accéder aux valeurs des enfants de ce noeud.

IndexOrName identifie le noeud enfant désiré par son interface ou par une chaîne indiquant le nom local du noeud enfant. Si IndexOrName n'identifie pas un enfant de ce noeud, le fait de tenter de récupérer ou de définir ChildValues déclenche une exception.

La valeur d'un noeud enfant dépend du type de cet enfant, comme l'indique le tableau suivant :



NodeType Valeur

ntElement

Si l'élément ne contient que du texte, il s'agit de cette valeur texte. Sinon, il s'agit de la valeur du premier noeud enfant.

ntText

Texte.

ntCData

Contenu de la section CDATA.

ntProcessingInstr

Contenu de l'instruction de traitement, à l'exception de la cible.

ntComment

Valeur (texte) du commentaire.

Si le noeud enfant est de tout autre type, le fait de lire ou de définir ChildValues déclenche une exception.



Remarque :  Dans Delphi, ChildValues est la propriété par défaut de IXMLNode. c'est-à-dire que vous pouvez omettre le nom de la propriété quand vous utilisez cette propriété. Par exemple :

Edit1.Text := XMLDocument1.DocumentElement.ChildValues['Name'];

peut également s'écrire :

Edit1.Text := XMLDocument1.DocumentElement['Name'];

Remarque :  Les attributs ne sont pas considérés comme des noeuds enfant d'un noeud. Pour obtenir ou définir les valeurs d'attributs de ce noeud, utilisez la propriété Attributes.

Voir aussi