XmlNew |
|
 |
Description
|
Creates an XML document object.
|
|
Returns
|
An empty XML document object.
|
|
Category
|
Extensibility functions, XML functions
|
|
Function syntax |
XmlNew([caseSensitive])
|
|
See also
|
cfxml, IsXmlDoc, XmlChildPos, XmlChildPos, XmlFormat, XmlParse, XmlSearch, XmlTransform
|
|
History
|
ColdFusion MX: Added this function.
|
|
Parameters
|
|
Parameter |
Description |
caseSensitive |
Determines how ColdFusion processes the case of XML document object |
|
component identifiers |
|
yes: maintains case |
|
no. ColdFusion ignores case. Default. |
|
|
Usage
|
An XML document object is represented in ColdFusion as a structure.
|
The caseSensitive attribute value determines whether identifiers whose characters are of varying case, but are otherwise the same, refer to different components. For example:
- If caseSensitive = "no", the names mydoc.employee.name[1] and mydoc.employee.NAME[1] refer to the same element
- If caseSensitive = "yes", these names refer to two distinct elements
|
The following example creates and displays a ColdFusion document object. For more information on this example, see Chapter 31, "Using XML and WDDX," in Developing ColdFusion MX Applications.
|
|
Example<cfset testVar = True>
<cfscript>
MyDoc = XmlNew();
MyDoc.xmlRoot = XmlElemNew(MyDoc,"MyRoot");
if (testVar IS TRUE)
MyDoc.MyRoot.XmlText = "The value of testVar is True.";
else
MyDoc.MyRoot.XmlText = "The value of testVar is False.";
for (i = 1; i LTE 4; i = i + 1)
{
MyDoc.MyRoot.XmlChildren[i] = XmlElemNew(MyDoc,"childNode");
MyDoc.MyRoot.XmlChildren[i].XmlText = "This is Child node " & i &".";
}
</cfscript>
<cfdump var=#MyDoc#>
|