メインコンテンツまでスキップ
バージョン: 20 R10 BETA

DOM Append XML child node

DOM Append XML child node ( elementRef ; childType ; childValue ) : Text

引数説明
elementRefTextXML要素参照
childTypeInteger追加する子のタイプ
childValueText, Blob子ノードとして挿入するテキストまたは (テキストあるいはBlob) 変数
戻り値Text子XML要素参照

説明

DOM Append XML child node コマンドを使用して、elementRefで指定したXMLノードにchildValueの値を追加できます。

作成されるノードのタイプをchildTypeで指定します。この引数には""テーマの以下の定数を渡すことができます:

定数
XML CDATA倍長整数7
XML comment倍長整数2
XML DATA倍長整数6
XML DOCTYPE倍長整数10
XML ELEMENT倍長整数11
XML processing instruction倍長整数3

childValueには挿入するデータを渡します。文字列または4D変数 (文字またはBLOB) を渡します。この引数の内容は常にテキストに変換されます。

Note: elementRef がドキュメントノード (トップレベルノード) を指す場合、コマンドは他のノードの前に"Doctype"ノードを挿入します。同じことが処理命令やコメントにも言えます。これらは常にルートノードの前 (かつDoctypeノードの後) に挿入されます。

例題 1

テキストタイプのノードを追加します:

 Reference:=DOM Create XML element(elementRef;"myElement")
DOM SET XML ELEMENT VALUE(Reference;"Hello")
temp:=DOM Create XML element(Reference;"br")
temp:=DOM Append XML child node(Reference;XML DATA;"New")
temp:=DOM Create XML element(Reference;"br")
temp:=DOM Append XML child node(Reference;XML DATA;"York")

結果:

<myElement>Hello<br/>New<br/>York</myElement>

例題 2

処理命令タイプのノードを追加します:

 $Txt_instruction:="xml-stylesheet type = \"text/xsl\" href=\"style.xsl\""
Reference:=DOM Append XML child node(elementRef;XML Processing Instruction;$Txt_instruction)

結果 (最初の要素の前に挿入される):

<?xml-stylesheet type="text/xsl" href="style.xsl"?>

例題 3

コメントタイプのノードを追加する:

 Reference:=DOM Append XML child node(elementRef;XML Comment;"Hello world")

結果:

<!--Hello world-->

例題 4

CDATAタイプのノードを追加する:

 Reference:=DOM Append XML child node(elementRef;XML CDATA;"12 < 18")

結果:

<element><![CDATA[12 < 18]]></element>

例題 5

Doctype 線減退のノードを追加あるいは置き換える:

 Reference:=DOM Append XML child node(elementRef;XML DOCTYPE;"Books SYSTEM \"Book.DTD\"")

結果 (最初の要素の前に挿入される):

<!DOCTYPEBooksSYSTEM"Book.DTD">

例題 6

要素タイプのノードを追加あるいは置き換える。

  • childValue 引数がXMLフラグメントの場合、子ノードとして挿入されます:
 Reference:=DOM Append XML child node(elementRef;XML ELEMENT;"simoneva") 

結果:

<parent>
<child>simon</child>
<child>eva</child>
</parent>
  • それ以外の場合、新しい空の子要素が追加されます:
 Reference:=DOM Append XML child node(elementRef;XML ELEMENT;"break") 

Result:

<parent>
<break/>
</parent>

childValue の内容が有効でない場合、エラーが返されます。

参照

DOM GET XML CHILD NODES
DOM Get XML document ref

プロパティ

コマンド番号1080
スレッドセーフである

AltStyle によって変換されたページ (->オリジナル) /