4D v14.3

DOM Append XML child node

Home

 
4D v14.3
DOM Append XML child node

DOM Append XML child node 


 

DOM Append XML child node ( ElementRef ; KindTyp ; KindWert ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
ElementRef  Text in XML Element Referenz
KindTyp  Lange Ganzzahl in Typ des anzuhängenden Kindelements
KindWert  Text, BLOB in Text oder Variable (Text oder BLOB), dessen Wert als Kindknoten eingefügt werden soll.
Funktionsergebnis  Text in Referenz des Kind XML Elements

Die Funktion DOM Append XML child node hängt den Wert KindWert an den in ElementRef definierten XML Knoten an.

Der Typ des erstellten Knotens wird im Parameter KindTyp definiert. Sie können eine der nachfolgenden Konstanten unter dem Thema XML übergeben:

Konstante Typ Wert
XML CDATA Lange Ganzzahl 7
XML comment Lange Ganzzahl 2
XML DATA Lange Ganzzahl 6
XML DOCTYPE Lange Ganzzahl 10
XML ELEMENT Lange Ganzzahl 11
XML processing instruction Lange Ganzzahl 3

In KindWert übergeben Sie die einzufügenden Daten. Sie können einen String oder eine 4D Variable übergeben (String oder BLOB). Der Inhalt dieses Parameters wird immer in Text konvertiert.

Hinweis: Gibt der Parameter ElementRef den Dokumentknoten an (Knoten auf der obersten Ebene), fügt die Funktion einen Knoten "Doctype" vor allen anderen Knoten ein. Das gleiche gilt auch für Arbeitsanweisungen und Kommentare. Sie werden immer vor dem Root Knoten, aber nach dem Doctype Knoten, eingefügt.

Knoten vom Typ Text hinzufügen:

 Reference:=DOM Create XML element(elementRef;"myElement")
 DOM SET XML ELEMENT VALUE(Reference;"Hallo")
 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")

Ergebnis:

<myElement>Hallo<br/>New<br/>York</myElement>

Knoten vom Typ Arbeitsanweisung hinzufügen:

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

Ergebnis (vor dem ersten Element eingefügt):

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

Knoten vom Typ Kommentar hinzufügen: 

 Reference:=DOM Append XML child node(elementRef;XML Comment;"Hallo Welt")

Ergebnis:

<!--Hallo Welt-->

Knoten vom Typ CDATA hinzufügen:

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

Ergebnis:

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

Knoten vom Typ Doctype declaration hinzufügen oder ersetzen:

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

Ergebnis (vor dem ersten Element eingefügt):

<!DOCTYPE Books SYSTEM  "Book.DTD">

Knoten vom Typ Element hinzufügen oder ersetzen:

  • Ist der Parameter KindWert ein XML Fragment, wird er als Kindknoten eingefügt:
     Reference:=DOM Append XML child node(elementRef;XML ELEMENT;"<child>simon</child><child>eva</child>")

    Ergebnis:
    <parent>
         <child>simon</child>
        <child>eva</child>
    </parent>

  • andernfalls wird ein neues leeres Kindelement angefügt
     Reference:=DOM Append XML child node(elementRef;XML ELEMENT;"tbreak")

    Ergebnis:
    <parent>
         <tbreak/>
     </parent>
Ist der Inhalt von KindWert nicht gültig, wird ein Fehler zurückgegeben.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: XML DOM
Nummer: 1080

 
GESCHICHTE 

Erstellt: 4D v12

 
SIEHE AUCH 

DOM GET XML CHILD NODES
DOM Get XML document ref

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)