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

XML ドキュメントオブジェクト要素

XML 関数

XmlElemNew(xmlObj[, namespace], childName)

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

ColdFusion MX 7: namespace パラメータが追加されました。

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

この関数の戻り変数は、ドキュメントオブジェクト内の新規要素の位置を指定します。xmlObj パラメータで識別される、ドキュメントオブジェクト内の有効な位置を指定する必要があります。次のステートメントに、その使用方法を示します。

MyDoc.MyRoot.XmlChildren[2] = XmlElemNew(MyDoc,"childNode");
ArrayAppend(MyDoc.MyRoot.XmlChildren, XmlElemNew(MyDoc,"childNode"));

namespace URI を指定しないで、childName パラメータで namespace 接頭辞を使用した場合、ColdFusion はその接頭辞について namespace URI が指定済みかどうかを確認し、指定されている場合はその namespace を使用します。

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

<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#>