4D v16.3

DOM Create XML Ref

Home

 
4D v16.3
DOM Create XML Ref

DOM Create XML Ref 


 

DOM Create XML Ref ( Root {; Namensraum} {; NameBerName ; NameBerWert} {; NameBerName2 ; NameBerWert2 ; ... ; NameBerNameN ; NameBerWertN} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
Root  String in Name des Root Elements
Namensraum  String in Wert von Namensbereich
NameBerName  String in Name von Namensbereich
NameBerWert  String in Wert von Namensbereich
Funktionsergebnis  String in Referenz auf Root XML Element

Die Funktion DOM Create XML Ref erstellt im Speicher einen leeren XML Baum und gibt dessen Referenz zurück.

Im Parameter Root übergeben Sie den Namen des Root Elements im XML Baum.

Übergeben Sie im optionalen Parameter Namensbereich die Deklaration des Wertes für den Namensbereich des Baums, z.B. “http:www.4d.com”.
Beachten Sie, dass Sie dem Parameter Root den Namen des Namensbereichs, gefolgt von einem Doppelpunkt, voranstellen können, z.B. “MeinNamensbereich:MeinRoot“.
In diesem Fall ist der Parameter Namensbereich, der den Wert Namensbereich angibt, zwingend.

Hinweis: Über Namensbereich können Sie sicherstellen, dass die XML Variablennamen einmalig sind. Das ist in der Regel eine URL wie http://www.mysite.com/myurl. Die URL muss nicht unbedingt gültig sein, sie muss jedoch einmalig sein.

Sie können über das Paar NameBerName/NameBerWert einen oder mehrere zusätzliche Namensbereiche im angelegten XML Baum festlegen. Sie können beliebig viele Paare übergeben.

Wichtig: Benötigen Sie die Funktion nicht länger, denken Sie daran, den Befehl DOM CLOSE XML mit dieser Referenz aufzurufen, um den Speicher wieder freizumachen.

Einen einzelnen XML Baum erstellen:

 C_TEXT(vElemRef)
 vElemRef:=DOM Create XML Ref("MyRoot")

Diese Methode erzeugt folgendes Ergebnis:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<MyRoot/>

Einen XML Baum mit einem einzelnen Namensbereich erstellen:

 C_TEXT(vElemRef)
 $Root:="MyNameSpace:MyRoot"
 $Namespace:="http://www.4D.com/tech/namespace"
 vElemRef:=DOM Create XML Ref($Root;$Namespace)

Diese Methode erzeugt folgendes Ergebnis:

<MyNameSpace:MyRoot xmlns:MyNameSpace="http://www.4D.com/tech/namespace"/>

Einen XML Baum mit mehreren Namensbereichen erstellen:

 C_TEXT(vElemRef)
 C_TEXT($aNSName1;$aNSName2;$aNSValue1;$aNSValue2)
 $Root:="MyNameSpace:MyRoot"
 $Namespace:="http://www.4D.com/tech/namespace"
 $aNSName1:="NSName1"
 $aNSName2:="NSName2"
 $aNSValue1:="http://www.4D.com/Prod/namespace"
 $aNSValue2:="http://www.4D.com/Mkt/namespace"
 vElemRef:=DOM Create XML Ref($Root;$Namespace;$aNSName1;$aNSValue1;$aNSName2;$aNSValue2)

Diese Methode erzeugt folgendes Ergebnis :

<MyNameSpace:MyRoot xmlns:MyNameSpace="http://www.4D.com/tech/nameSpace"
NSName1="http://www.4D.com/Prod/namespace"
NSName2="http://www.4D.com/Mkt/namespace"/>

Bei korrekt ausgeführter Funktion wird die Variable OK auf 1 gesetzt, sonst auf 0 (Null) und ein Fehler wird generiert.



Siehe auch 

DOM CLOSE XML
DOM SET XML DECLARATION

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: XML DOM
Nummer: 861

Dieser Befehl ändert die Systemvariable OKDieser Befehl ändert die Systemvariable ErrorThis command can be run in preemptive processes

 
GESCHICHTE 

Erstellt: 4D 2004

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)