ST_XmlItem

Descripción general

Tipo:	Estructura
Disponible desde:	V1.0.8.0
Hereda de:	-

Descripción

La estructura ST_XmlItem se utiliza para describir un elemento o un atributo que se lee o escribe en un archivo XML.

Elementos de la estructura

Nombre	Tipo de datos	Descripción
diParentIndex	DINT	Indica el índice de la matriz en el que se encuentra el elemento padre del elemento XML (consulte Ejemplo de relaciones jerárquicas indicadas por uiParentIndex). Si el valor es –1, el elemento es un elemento raíz.
sName	STRING[GPL.Gc_uiXmlLengthOfString]	Nombre del elemento o atributo.
sValue	STRING[GPL.Gc_uiXmlLengthOfString]	Valor del elemento o atributo.
etType	ET_XmlItemType	Indica el tipo del elemento XML.
uiNumOfAttributes	ULINT	Este valor depende del tipo del elemento XML: oSi es del tipo elemento, el valor indica el número de atributos asociados. oSi del tipo atributo, el valor indica el número correlativo.

Utilizado por

oFB_XmlRead

oFB_XmlWrite

Ejemplo de relaciones jerárquicas indicadas por uiParentIndex

En el ejemplo se ilustra la correlación entre el parámetro uiParentIndex del búfer de tipo XmlItems proporcionado por la aplicación y la estructura jerárquica en el documento XML.

Documento XML	Búfer del tipo XmlItems proporcionado por la aplicación
<?xml version="1.0" encoding="ASCII"?> <AAA> <BBB /> <CCC /> <DDD> <EEE /> </DDD> </AAA>

Documento XML

Búfer del tipo XmlItems proporcionado por la aplicación

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

Elemento	Índice padre	Explicación
AAA	–1	AAA es el elemento raíz. No tiene objeto padre.
BBB	0	AAA es el elemento padre. Se almacena en un índice de matriz 0.
CCC	0
DDD	0
EEE	3	DDD es el elemento padre. Se almacena en un índice de matriz 3.