Version 2004
SAX GET XML ELEMENT (Dokument; Name; Vorsilbe; AttrName; AttrWert)
Parameter | Typ | Beschreibung | |
Dokument | 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 Dokument 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.
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", tAttrValues{2} enthält "222", tAttrValues{3} enthält "333"
Referenz
Systemvariablen oder Mengen
Bei korrekt ausgeführtem Befehl wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null) und ein Fehler wird zurückgegeben.