XML ドキュメントオブジェクトを作成します。

空の XML ドキュメントオブジェクト

XML 関数

XmlNew([caseSensitive])

cfxml、IsXmlDoc、ToString、XmlFormat、XmlParse、XmlValidate、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」

ColdFusion MX: この関数が追加されました。

ColdFusion では、XML ドキュメントオブジェクトを構造体として表現します。

大文字と小文字だけが異なる複数の識別子がそれぞれ別のコンポーネントを参照するかどうかは、caseSensitive パラメータ値によって決まります。例 :

• true の場合、要素または属性名 "name" および "NAME" は、別々の要素または属性を参照します。
• false の場合、これらの名前は同じ要素または属性を参照します。

XML オブジェクトで大文字と小文字が区別される場合、ドット表記法を使用して要素または属性の名前を参照することはできません。代わりに、連想配列 (括弧) 表記法による名前を使用するか、大文字と小文字を区別する名前を使わない参照を使用 (xmlChildren[1] など) します。次のコードで、最初の行は大文字と小文字を区別する XML オブジェクトに機能します。2 番めと 3 番めの行ではエラーが発生します。

MyDoc.xmlRoot.XmlAttributes["Version"] = "12b";
MyDoc.xmlRoot.XmlAttributes.Version = "12b";
MyDoc.MyRoot.XmlAttributes["Version"] = "12b";

XML ドキュメントオブジェクトを文字列に変換するには、ToString 関数を使用してください。

次の例では、ColdFusion ドキュメントオブジェクトを作成および表示します。

<cfset testVar = True>
<cfscript>
   MyDoc = XmlNew();
   MyDoc.xmlRoot = XmlElemNew(MyDoc,"MyRoot");
   if (testVar IS TRUE)
      MyDoc.MyRoot.XmlText = "testVar の値は true です。";
   else
      MyDoc.MyRoot.XmlText = "testVar の値は false です。";
   for (i = 1; i LTE 4; i = i + 1)   {
      MyDoc.MyRoot.XmlChildren[i] = XmlElemNew(MyDoc,"childNode");
      MyDoc.MyRoot.XmlChildren[i].XmlText = "これは子ノード " & i &" です。";
      }
</cfscript>
<cfdump var=#MyDoc#>