ST_XmlItem

Übersicht

Typ:	Struktur
Verfügbar ab:	V1.0.8.0
Übernommen aus	-

Beschreibung

Die Struktur ST_XmlItem ermöglicht die Beschreibung eines Elements oder Attributs, das aus einer XML-Datei ausgelesen bzw. in diese geschrieben wird.

Strukturelemente

Name	Datentyp	Beschreibung
diParentIndex	DINT	Verweist auf den Index des Arrays, in dem sich das übergeordnete Element der XML-Einheit befindet (siehe Beispiel für die von uiParentIndex angegebenen hierarchischen Beziehungen). Wenn der Wert -1 ist, handelt es sich bei dem Element um ein Stammelement.
sName	STRING[GPL.Gc_uiXmlLengthOfString]	Name des Elements oder Attributs.
sValue	STRING[GPL.Gc_uiXmlLengthOfString]	Wert des Elements oder Attributs.
etType	ET_XmlItemType	Gibt den Typ der XML-Einheit an.
uiNumOfAttributes	ULINT	Dieser Wert ist vom Typ der XML-Einheit abhängig: oWenn die Einheit vom Typ Element ist, gibt der Wert die Anzahl der zugehörigen Attribute an. oWenn die Einheit vom Typ Attribut ist, verweist der Wert auf die Sequenznummer.

Verwendet von

oFB_XmlRead

oFB_XmlWrite

Beispiel für die von uiParentIndex angegebenen hierarchischen Beziehungen

Dieses Beispiel illustriert die Beziehung zwischen dem Parameter uiParentIndex in dem von der Anwendung bereitgestellten Puffer des Typs XmlItems und der hierarchischen Struktur im XML-Dokument.

XML-Dokument	Von der Anwendung bereitgestellter Puffer des Typs XmlItems
<?xml version="1.0" encoding="ASCII"?> <AAA> <BBB /> <CCC /> <DDD> <EEE /> </DDD> </AAA>

XML-Dokument

Von der Anwendung bereitgestellter Puffer des Typs XmlItems

<?xml version="1.0" encoding="ASCII"?>
<AAA>
   <BBB />
   <CCC />
     <DDD>
       <EEE />
     </DDD>
</AAA>

Element	Übergeordneter Index	Bedeutung
AAA	–1	AAA ist das Stammelement. Das Stammelement besitzt kein übergeordnetes Element.
BBB	0	AAA ist das übergeordnete Element. Es wird im Array-Index 0 gespeichert.
CCC	0
DDD	0
EEE	3	DDD ist das übergeordnete Element. Es wird im Array-Index 3 gespeichert.