Xml.XMLDoc.TXMLNode.CreateCollection

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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());

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function protected
Xml.XMLDoc.pas
Xml.XMLDoc.hpp
Xml.XMLDoc TXMLNode

Beschreibung

Erstellt eine Instanz einer von TXMLNodeCollection abgeleiteten Klasse und gibt diese zurück.

CreateCollection ist als protected deklariert und kann in Anwendungen nicht verwendet werden. Die Methode wird intern aufgerufen, um die Kollektionen für die Eigenschaft HostedNodes zu erstellen.

CollectionClass gibt die Implementierungsklasse (abgeleitet von TXMLNodeCollection) für die Kollektion der untergeordneten Knoten an.

ItemInterface gibt das Interface für jeden untergeordneten Knoten in der Kollektion an.

ItemTag ist der Tag-Name für jeden untergeordneten Knoten in der Kollektion.

ItemNS übergibt den Namespace, in dem ItemTag definiert ist.

CreateCollection gibt den neuen Kollektionsknoten zurück. Der neue Knoten ist in den Eigenschaften für den übergeordneten Knoten, das DOM-Interface, die Attributknoten und die untergeordneten Knoten mit dem aktuellen Knoten identisch, verwaltet aber zusätzlich eine Liste, die nur die Unterknoten mit dem angegebenen Tag und dem angegebenen Interface enthält. Der XML-Knoten wird der Eigenschaft HostNode zugewiesen.

Anmerkung:  CreateCollection löst eine Exception aus, wenn das Objekt für einen Teilknoten verwendet wird.

Siehe auch