MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX, Develop Manual

Page: 678 / 860

678 Chapter 31: Using XML and WDDX
•
Use associative array (bracket) notation to specify an element name that contains a period or
colon; for example,
myotherdoc.XmlRoot["Type1.Case1"]
.
•
You can use DOM methods in place of structure entry names.
For example, the following variables all refer to the
XmlText
value “Almanzo” in the XML
document created in “A simple XML document” on page 671 :
mydoc.XmlRoot.XmlChildren[1].XmlChildren[1].XmlText
mydoc.employee.name[1].first.XmlText
mydoc.employee.name[1]["first"].XmlText
mydoc["employee"].name[1]["first"].XmlText
mydoc.XmlRoot.name[1].XmlChildren[1]["XmlText"]
The following variables all refer to the EmpType attribute of the first name element in the XML
document created in
“A simple XML document” :
mydoc.employee.name[1].XmlAttributes.EmpType
mydoc.employee.name[1].XmlAttributes["EmpType"]
mydoc.employee.XmlChildren[1].XmlAttributes.EmpType
mydoc.XmlRoot.name[1].XmlAttributes["EmpType"]
mydoc.XmlRoot.XmlChildren[1].XmlAttributes.EmpType
Neither of these lists contains a complete set of the possible combinations that can make up a
reference to the value or attribute.
Assigning data to an XML object
When you use an XML object reference on the left side of an expression, the preceding rules apply
to the reference up to the last element in the reference string.
For example, the rules in “Referencing the contents of an XML object” on page 677 apply to
mydoc.employee.name[1].first in the following expression:
mydoc.employee.name[1].first.MyNewElement = XmlElemNew(mydoc, NewElement);
Referencing the last element on the left side of an expression
The following rules apply to the meaning of the last component on the left side of an expression:
•
The component name is an element structure key name (XML property name), such as
XmlComment
, ColdFusion sets the value of the specified element structure entry to the value of
the right side of the expression. For example, the following line sets the XML comment in the
mydoc.employee.name[1].first element to “This is a comment”:
mydoc.employee.name[1].first.XmlComment = "This is a comment";
•
If the component name specifies an element name and does not end with a numeric index, for
example
mydoc.employee.name
, ColdFusion assigns the value on the right of the expression
to the first matching element.
For example, if both
mydoc.employee.name[1]
and
mydoc.employee.name[2]
exist, the
following expression replaces
mydoc.employee.name[1]
with a new element named address,
not an element named name:
mydoc.employee.name = XmlElemNew(mydoc, "address");
After executing this line, if there had been both
mydoc.employee.name[1]
and
mydoc.employee.name[2]
, there is now only one
mydoc.employee.name
element with the
contents of the original
mydoc.employee.name[2]
.