4D Doc Center : SAX GET XML ELEMENT

Home

4D v14.3

SAX GET XML ELEMENT


SAX GET XML ELEMENT ( DokRef ; Name ; Vorsilbe ; attrName ; attrWert )

Parameter	Typ	Beschreibung
DokRef	DokRef	Referenz auf offenes Dokument
Name	String	Elementname
Vorsilbe	String	Namensbereich
attrName	Array String	Attributnamen
attrWert	Array String	Attributwerte

Beschreibung

Der Befehl SAX GET XML ELEMENT gibt verschiedene Informationen über das Element Name im XML Dokument, definiert durch DokRef zurück. Er muss mit den Ereignissen XML Start Element oder XML End Element aufgerufen werden. Bei XML End Element werden die Parameter für Attribute nicht verwendet. Weitere Informationen über SAX Ereignisse finden Sie in der Beschreibung zur Funktion SAX Get XML node.

Name enthält den Namen des Elements.

Vorsilbe gibt den Namensbereich des Elements zurück. Der Parameter ist leer, wenn kein Namensbereich mit dem Element verknüpft ist.

Der Befehl füllt das Array attrName mit den Attributnamen des Zielelements. Bei Bedarf erstellt er das Array automatisch und in der passenden Größe.

Der Befehl füllt auch das Array attrWert mit den Attributwerten des Zielelements. Bei Bedarf erstellt er das Array automatisch und in der passenden Größe.

Beispiel

Sehen wir uns folgenden Teil von XML Code an:

<RootElement>
   <Child Att1="111" Att2="222" Att3="333">MyText</Child>
</RootElement>

Nach Ausführung der folgenden Anweisung gilt:

SAX GET XML ELEMENT(DocRef;vName;vPrefix;tAttrNames;tAttrValues)

... vName enthält “Child”
vPrefix enthält “”
tAttrNames{1} enthält “Att1”, tAttrNames{2} enthält “Att2”, tAttrNames{3} enthält “Att3”
tAttrValues{1} enthält “111”, tAttrNames{2} enthält “222”, tAttrValues{3} enthält “333”

Systemvariablen und Mengen

Bei korrekt ausgeführtem Befehl wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null) und ein Fehler wird zurückgegeben.