User Guide

178 Server-Side ActionScript Language Reference

XML.createElement()

Availability

Flash Media Server 2.

Usage

my_xml.createElement(name)

Parameters

name The tag name of the XML element being created.

Returns

An XML node; an XML element.

Description

Method; creates a new XML element with the name specified in the name parameter. The new

element initially has no parent, children, or siblings. The method returns a reference to the

newly created XML object that represents the element. This method and the

XML.createTextNode() method are the constructor methods for creating nodes for an XML

object.

Example

The following example creates three XMLNode objects using the createElement() method:

// Create an XML document.

var doc = new XML();

// Create three XML nodes using createElement().

var element1 = doc.createElement("element1");

var element2 = doc.createElement("element2");

var element3 = doc.createElement("element3");

// Place the new nodes into the XML tree.

doc.appendChild(element1);

element1.appendChild(element2);

element1.appendChild(element3);

trace(doc);

// Output: <element1><element2 /><element3 /></element1>