Contents > Developing ColdFusion MX Applications > Using XML and WDDX > Modifying a ColdFusion XML object > XML document object management reference PreviousNext

XML document object management reference

The following tables provide a quick reference to the ways you can modify the contents of an XML document object. The sections that follow describe in detail how to modify XML contents.

Adding

Use the following techniques to add new information to an element:

Type

Using a function

Using an assignment statement

Attribute

 
StructInsert(xmlElemPath.XmlAttributes, 
   "key", "value")

xmlElemPath.XmlAttributes.key =
   "value"

xmlElemPath.XmlAttributes["key"] 
   = "value"

Child element

To append:

ArrayAppend(xmlElempath.XmlChildren,
   newElem)

To insert:

ArrayInsertAt(xmlElempath.
   XmlChildren, position, newElem)

To append:

xmlElemPath.XmlChildren[i] =
   newElem

xmlElemPath.newChildName =
   newElem

(where newChildName must be the same as newElem.XmlName and cannot be an indexed name such as name[3])

Deleting

Use the following techniques to delete information from an element:

Type

Using a function

Using an assignment statement

Property

 
StructDelete(xmlElemPath, propertyName)

xmlElemPath.propertyName=""

Attribute

All attributes:

StructDelete(xmlElemPath, XmlAttributes)

A specific attribute:

StructDelete(xmlElemPath.XmlAttributes,
"attributeName")

Not available

Child element

All children of an element:

StructDelete(xmlElemPath, "XmlChildren")
or
ArrayClear(xmlElemPath.XmlChildren)

All children with a specific name:

StructDelete(xmlElementpath,
   "elemName")
ArrayClear(xmlElemPath.elemName)

A specific child:

ArrayDeleteAt(xmlElemPath.XmlChildren,
   position)
ArrayDeleteAt(xmlElemPath.elemName,
   position)

Not available

Changing

Use the following techniques to change the contents of an element:

Type

Using a function

Using an assignment statement

Property

 
StructUpdate(xmlElemPath,
   "propertyName", "value")

xmlElemPath.propertyName =
   "value"

xmlElemPath["propertyName"] =
   "value"

Attribute

 
StructUpdate(xmlElemPath.XmlAttributes,
   "attributeName", "value")


xmlElemPath.XmlAttributes.
   attributeName="value"

xmlElemPath.XmlAttributes
   ["attributeName"] = "value"

Child element

(replace)

 
ArraySet(xmlElemPath.XmlChildren, index,
   index, newElement)

(use the same value for both index entries to change one element)

Replace first or only child named elementName:

parentElemPath.elementName =
   newElement

parentElemPath["elementName"]
   = newElement

Replace a specific child named elementName:

parentElemPath.elementName
   [index] = newElement

or

parentElemPath["elementName"]
   [index] = newElement
Contents > Developing ColdFusion MX Applications > Using XML and WDDX > Modifying a ColdFusion XML object > XML document object management reference PreviousNext

ColdFusion 9 | ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | Bug Reporting

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.