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.

Note: 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.

Adding information to an element

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 information from an element

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 contents of an element

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

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

Version 7

 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/7/htmldocs/00001516.htm