User Guide

850 Chapter 35: Using XML and WDDX
ColdFusion XML tag and functions
The following table lists the ColdFusion tag (cfxml) and functions that create and manipulate
XML documents:
Tag or function Description
<cfxml
variable="objectName"
[caseSensitive="Boolean"]>
Creates a new ColdFusion XML document object consisting of the
markup in the tag body. The tag can include XML and CFML tags.
ColdFusion processes all CFML in the tag body before converting
the resulting text to an XML document object.
If you specify the
CaseSensitive="True" attribute, the case of
names of elements and attributes in the document is meaningful.
The default value is
False.
For more information on using the
cfxml tag, see “Creating a new
XML document object using the cfxml tag” on page 856.
XmlParse
(XMLText
[[, caseSensitive],
validator])
Converts an XML document in a file or a string variable into an XML
document object, and optionally validates the document against a
DTD or schema.
If you specify the optional second argument as
True, the case of
names of elements and attributes in the document is meaningful.
The default value is
False.
For more information on using the
XmlParse function, see “Creating
an XML document object from existing XML” on page 857.
XmlNew
([caseSensitive])
Returns a new, empty XML document object.
If you specify the optional argument as
True, the case of names of
elements and attributes in the document is meaningful. The default
value is
False.
For more information on using the
XmlNew function, see “Creating a
new XML document object using the XmlNew function”
on page 856.
XmlElemNew
(objectName{,
namespaceURI],
elementName)
Returns a new XML document object element with the specified
name, optionally belonging to the specified namespace. You can
omit the
namespaceURI parameter and use only a namespace prefix
if the prefix is defined elsewhere in the object.
For more information on using the
XmlElemNew function, see
“Adding an element” on page 863.
XmlTransform
(XMLVar,
XSLTStringVar[,
parameters])
Applies an Extensible Stylesheet Language Transformation
(XSLT) to an XML document. The document can be represented
as a string variable or as an XML document object. The function
returns the resulting XML document as a string.
For more information on using the
XmlTransform function, see
“Transforming documents with XSLT” on page 869.
XmlSearch
(objectName,
XPathExpression)
Uses an XPath expression to search an XML document object and
returns an array of XML elements that match the search criteria.
For more information on using the
XmlSearch function, see
“Extracting data with XPath” on page 869.