Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com

Home

 
4D v20 R7
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 OKKann zu Speicherlücken führen, wenn der Code Referenzen nicht nach Verwendung löschtDieser Befehl ändert die Systemvariable ErrorDieser Befehl kann in preemptive Prozessen laufen

 
SEITENINHALT 
 
GESCHICHTE 

Erstellt: 4D 2004

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v20 R7)