XmlDocumentCreateElement

value XmlDocumentCreateElement ( value xmlDocument, value BYREF xmlElement, string strTagName );

Rückgabewert

Rückgabewert

Beschreibung

value (!=0)

Das neue XML-Element-Objekt xmlElement des XML-Dokument-Objekts xmlDocument.

0

Beim Anlegen des XML-Element-Objekts im XML-Dokument-Objekt xmlDocument ist ein Fehler aufgetreten.

Parameter

xmlDocument

Das XML-Dokument-Objekt, zu dem ein XML-Element-Objekt erzeugt werden soll.

xmlElement

Die Variable, die mit dem erzeugtem, dem XML-Document-Objekt zugehörigen, XML-Element-Objekt geladen wird.

strTagName

Der Tagname, den das neue XML-Element-Objekt erhalten soll.

Bemerkung

Erzeugt ein neues XML-Element-Objekt xmlElement das dem XML-Dokument-Objekt xmlDocument zugehörig ist (d.h. es kann nicht für ein anderes XML-Dokument-Objekt verwendet werden oder dorthin übertragen werden).
Es ist zu beachten, dass ein erzeugtes XML-Element-Objekt einem Knoten des XML-Baums mit XmlNodeAppendChild  hinzugefügt werden muss, damit das XML-Element-Objekt im XML-Baum einen Platz einnimmt. Das erzeugte und hinzugefügte XML-Element-Objekt selbst ist dann ein Knoten innerhalb des XML-Baums, dem wiederrum XML-Element-Objekte als Kind-Knoten mit XmlNodeAppendChild hinzugefügt werden können.

Beim Beenden von Victory werden alle geöffneten und nicht geschlossenen XML-Dokument-Objekte und deren XML-Element-Objekte (sofern vorhanden und noch geöffnet) automatisch geschlossen.

Beispiele

In diesem Beispiel wird eine XML-Datei erzeugt das Aufträge enthält.

//CreateOrdersXmlDocument ()
//
//////////////////////////////////////////////////////////////////////
value xmlDocument, xmlRoot, xmlOrder;
string orderNo, productNo, quantity;

XmlDocumentCreate(xmlDocument);
XmlDocumentAppendProcessingInstruction(xmlDocument, "xml","version=\"1.0\"");

XmlDocumentCreateElement(xmlDocument, xmlRoot, "Orders");
XmlNodeAppendChild(xmlDocument, xmlRoot);

XmlDocumentCreateElement(xmlDocument, xmlOrder, "Order");
XmlElementSetAttribute(xmlOrder, "OrderNo", "29810");
XmlElementSetAttribute(xmlOrder, "ProductNo", "7993-12");
XmlElementSetAttribute(xmlOrder, "Quantity", "10");
XmlNodeAppendChild(xmlRoot, xmlOrder);

XmlDocumentCreateElement(xmlDocument, xmlOrder, "Order");
XmlElementSetAttribute(xmlOrder, "OrderNo", "29811");
XmlElementSetAttribute(xmlOrder, "ProductNo", "4232-01");
XmlElementSetAttribute(xmlOrder, "Quantity", "14");
XmlNodeAppendChild(xmlRoot, xmlOrder);

XmlDocumentToFile(xmlDocument, "orders.xml");
 

Siehe auch XmlDocumentCreateFromFile, XmlDocumentCreateFromString, XmlDocumentCreate, XmlDocumentToFile, XmlDocumentToString, XmlDocumentClose, XmlDocumentAppendProcessingInstruction, XmlDocumentRootElement, XmlDocumentCreateTextNode, XmlElementAttribute, XmlElementTagName, XmlElementText, XmlElementSetAttribute, XmlElementSetTagName, XmlElementNextSibling, XmlElementPrevSibling, XmlNodeAppendChild, XmlNodeFirstChildElement, XmlNodeLastChildElement