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