Xml.XMLDoc.TXMLNode.CreateCollection

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function CreateCollection(const CollectionClass: TXMLNodeCollectionClass;  const ItemInterface: TGuid; const ItemTag: DOMString; ItemNS: DOMString = ''): TXMLNodeCollection;

C++

TXMLNodeCollection* __fastcall CreateCollection(const TXMLNodeCollectionClass CollectionClass, const GUID &ItemInterface, const System::UnicodeString ItemTag, System::UnicodeString ItemNS = System::UnicodeString());

Propriétés

Type Visibilité  Source Unité  Parent
function protected
Xml.XMLDoc.pas
Xml.XMLDoc.hpp
Xml.XMLDoc TXMLNode

Description

Crée une instance d'un descendant TXMLNodeCollection et la renvoie.

Les applications ne peuvent pas appeler la méthode protégée CreateCollection. Elle est utilisée de manière interne pour générer les collections répertoriées dans la propriété HostedNodes.

CollectionClass spécifie la classe (descendant de TXMLNodeCollection) qui implémente la collection de noeuds enfant.

ItemInterface indique l'interface de chaque noeud enfant de la collection.

ItemTag désigne le nom de balise de chaque noeud enfant de la collection.

ItemNS spécifie l'espace de nommage dans lequel ItemTag est défini.

CreateCollection renvoie le nouveau noeud de collection hébergé. Ce nouveau noeud possède les mêmes noeud parent, interface DOM, noeuds d'attribut et noeuds enfant que ce noeud mais il gère également une liste dans laquelle ne figurent que les noeuds enfant possédant la balise et l'interface spécifiées. Le nouveau noeud de collection répertorie ce noeud en tant que valeur de sa propriété HostNode.

Remarque :  CreateCollection déclenche une exception s'il s'agit d'un noeud hébergé.

Voir aussi