MACROMEDIA COLFUSION MX 7-CFML, Reference

Page: 447 / 1108

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.
Category
Extensibility tags
Syntax
<CFXML
variable="xmlVarName"
caseSensitive="yes" or "no">
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