4D v14.3

DOM EXPORT TO VAR

Página Inicial

 
4D v14.3
DOM EXPORT TO VAR

DOM EXPORT TO VAR 


 

DOM EXPORT TO VAR ( refElemento ; vXMLVar ) 
Parâmetro Tipo   Descrição
refElemento  cadeia in Referência do elemento Root XMLK
vXMLVar  Texto, BLOB in Variável que recebe a árvore XML

O comando DOM EXPORT TO VAR  permite salvar um árvore XML em uma variável texto ou BLOB.

Passe em refElemento a referência do elemento raiz a exportar.

Passe em vXMLVar o nome da variável que deve conter a árvore XML. Esta variável pode ser de tipo Texto ou BLOB. Pode selecionar o tipo em função das operações a ser realizada ou do tamanho que a árvore possa alcançar (lembre que em modo Unicode, as variáveis de tipo Texto estão limitadas a 32 K de texto, enquanto em modo Unicode, este limite é de 2 GB).

Lembre que se utilizar uma variável de tipo texto para armazenar o elemento refElemento, em modo não Unicode, será codificado utilizando o conjunto de caracteres Mac “atual” (é dizer, Mac Romam na maioria dos sistemas ocidentais). Isso significa que o texto retornado perderá sua codificação original (encoding="xxx"). Neste caso, as variáveis vXMLVar permite visualizar ou armazenar o código obtido mas NÃO para gerar um documento XML válido (utilizando o comando SEND PACKET por exemplo).

Em modo Unicode, o código original se conserva na variável.

Em XML, os saltos de linha não são significativos, independentemente se encontram dentro ou entre os elementos XML. Internamente, XML utiliza caracteres estandarte LF como separadores de linhas.

Durante as operações de importação e exportação, os caracteres de salto de linha se podem converter. Durante uma importação, o analisador XML substitui os caracteres CRLF (rupturas de linha estandarte em Windows) por caracteres de LF. Durante a exportação, os caracteres LF se substituem por caracteres CR.

Se deseja manter os retornos de carro, deve incluir em um elemento XML CDATA de forma que não seja processado pelo analisador XML. Em lugar de caracteres CRLF, também pode utilizar o caractere "<br/>", que é um retorno de carro explícito que não será processado pelo analisador.

Exemplo  

Este exemplo salva a árvore vRefElem em uma variável texto:

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

Se o comando for executado corretamente, a variável sistema OK assume o valor 1. Do contrário, assume o valor 0 e um erro é gerado (por exemplo, se a referência do elemento não for válida).

 
PROPRIEDADES 

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

Este comando modifica a variável sistema OKEste comando modifica a variável sistema ErrorO modo Unicode afeta este comando

 
HISTÓRIA 

Criado por: 4D 2004

 
VER TAMBÉM 

DOM EXPORT TO FILE
SVG EXPORT TO PICTURE

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)