SAX OPEN XML ELEMENT

4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 2004


SAX OPEN XML ELEMENT (document; tag{; attribName; attribValue}{; attribName2; attribValue2; ...; attribNameN; attribValueN})

ParámetroTipoDescripción
documentDocRefReferencia del documento abierto
etiquetaCadenaNombre del elemento a abrir
nomAtribCadenaNombre del atributo
valorAtribCadenaValor del atributo

Descripción

El comando SAX OPEN XML ELEMENT permite añadir un nuevo elemento en el documento XML referenciado por document como también, opcionalmente, atributos y sus valores.

El elemento añadido está "abierto" en el documento (la etiqueta de fin no está añadida). Para cerrar un elemento creado utilizando este comando, debe:

Utilizar el comando SAX CLOSE XML ELEMENT, o

Cerrar el documento XML. En este caso, 4D añadirá automáticamente las etiquetas XML de cierre necesarias.

En etiqueta, pase el nombre del elemento a crear. Este nombre sólo puede contener letras, números y los caracteres ".", "-","_" y ":". Si se pasa un caracter inválido en etiqueta, se generará un error.

Opcionalmente, el comando permite pasar uno o varios pares de atributos/valores (en forma de variables, campos o valores literales) utilizando los parámetros nomAtrib y valorAtrib. Puede pasar tantos pares atributo/valor como quiera.

Ejemplo

La siguiente instrucción:

   vElement:="Libro"
   SAX OPEN XML ELEMENT($DocRef;vElement)

... escribirá la siguiente línea en el documento:

<Book

Ver también

SAX CLOSE XML ELEMENT, SAX OPEN XML ELEMENT ARRAYS.

Gestión de errores

Si se pasa en tag un carácter inválido, se genera un error.


4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente