4D v16.3

DOM EXPORT TO VAR

Inicio

 
4D v16.3
DOM EXPORT TO VAR

DOM EXPORT TO VAR 


 

DOM EXPORT TO VAR ( elementRef ; vXmlVar ) 
Parámetro Tipo   Descripción
elementRef  Cadena in Referencia del elemento XML raíz
vXmlVar  Texto, BLOB in Variable a recibir el árbol XML

El comando DOM EXPORT TO VAR  permite guardar un árbol XML en una variable texto o BLOB.

Pase en elementRef la referencia del elemento raíz a exportar.

Pase en vXmlVar el nombre de la variable que debe contener el árbol XML. Esta variable puede ser de tipo Texto o BLOB. Puede seleccionar el tipo en función de las operaciones a efectuar o del tamaño que el árbol pueda alcanzar (recuerde que en modo Unicode, las variables de tipo Texto están limitadas a 32 K de texto, mientras en modo Unicode, este límite es de 2 GB).

Recuerde que si utiliza una variable de tipo texto para almacenar el elemento refElement, en modo no Unicode, será codificado utilizando el conjunto de caracteres Mac “actual” (es decir, Mac Roman en la mayoría de los sistemas occidentales). Esto significa que el texto devuelto perderá su codificación original (encoding="xxx"). En este caso, la variables vVarXml permite visualizar o almacenar el código obtenido pero NO generar un documento XML válido (utilizando el comando SEND PACKET por ejemplo).

En modo Unicode, el código original se conserva en la variable.

En XML, los saltos de línea no son significativos, independientemente de si se encuentran dentro o entre los elementos XML. Internamente, XML utiliza caracteres estándar LF como separadores de líneas.

Durante las operaciones de importación y exportación, los caracteres de salto de línea se pueden convertir. Durante una importación, el analizador XML reemplaza los caracteres CRLF (rupturas de línea estándar en Windows) por caracteres de LF. Durante la exportación, los caracteres LF se sustituyen por caracteres CR en MacOs y por CRLF en Windows.

Si desea mantener los retornos de carro, debe incluir en un elemento XML CDATA de manera que no sea procesado por el analizador XML. En lugar de caracteres CRLF, también puede utilizar el carácter "<br/>", que es un retorno de carro explícito que no será procesado por el analizador.

Ejemplo  

Este ejemplo guarda el árbol vRefElem en una variable texto:

 C_TEXT(vtMiTexto)
 DOM EXPORT TO VAR(vRefElem;vtMiTexto)

Si el comando se ejecutó correctamente, la variable sistema OK toma el valor 1. De lo contrario, toma el valor 0 y se genera un error (por ejemplo, si la referencia del elemento no es válida).



Ver también 

DOM EXPORT TO FILE
SVG EXPORT TO PICTURE

 
PROPIEDADES 

Producto: 4D
Tema: XML DOM
Número 863

Este comando modifica la variable sistema OKEste comando modifica la variable sistema ErrorThis command can be run in preemptive processesEl modo Unicode afecta este comando

 
HISTORIA 

Creado por: 4D 2004

 
ARTICLE USAGE

Manual de lenguaje 4D ( 4D v16)
Manual de lenguaje 4D ( 4D v16.1)
Manual de lenguaje 4D ( 4D v16.2)
Manual de lenguaje 4D ( 4D v16.3)