DOM Append XML child node

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

引数	型		説明
elementRef	Text	→	XML要素参照
childType	Integer	→	追加する子のタイプ
childValue	Text, 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\"")

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

<!DOCTYPE  Books SYSTEM  "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
スレッドセーフである	✓