User Guide

cfxml 447

cfxml

Description

Creates a ColdFusion XML document object that contains the markup in the tag body. This tag

can include XML and CFML tags. ColdFusion processes the CFML code in the tag body, and

then assigns the resulting text to an XML document object variable, which is always stored in

Unicode.

See also

IsXmlDoc

, IsXmlElem, IsXmlRoot, ToString, XmlChildPos, XmlNew, XmlParse, XmlSearch,

XmlTransform; Chapter 35, “Using XML and WDDX” in ColdFusion MX Developer’s Guide

History

ColdFusion MX 7: Added support for using an XML declaration at the start of the text.

ColdFusion MX: Added this tag.

Attributes

Usage

If your XML object is case-sensitive, you cannot use dot notation to reference an element or

attribute name. Use the name in associative array (bracket) notation, or a reference that does not

use the case-sensitive name (such as xmlChildren[1]) instead. In the following code, the first line

will work with a case-sensitive XML object. The second and third lines cause errors:

MyDoc.xmlRoot.XmlAttributes["Version"] = "12b";

MyDoc.xmlRoot.XmlAttributes.Version = "12b";

MyDoc.MyRoot.XmlAttributes["Version"] = "12b";

Use the XmlFormat function to escape special characters such as &, > and <.

To convert an XML document object back into a string, use the

ToString function, at which

time ColdFusion automatically prepends the <?xml version="1.0" encoding="UTF-8" ?> XML

declaration

Attribute Req/Opt Default Description

variable Name of the document object.

caseSensitive Optional no • yes: maintains the case of document elements and

attributes.

• no