SAX SET XML DECLARATION

4D v18


SAX SET XML DECLARATION ( documento ; codificaçao {; autonomo {; recuo}} )

Parâmetro	Tipo	Descrição
documento	refDoc	Referência do documento aberto
codificaçao	String	Conjunto de caracteres usado no documento XML
autonomo	Booleano	True= o documento é autônomo (standalone); False (padrão) = documento não é standalone
recuo	Booleano	*Obsoleto, não usar*

Descrição

O comando SAX SET XML DECLARATION inicializa o documento XML referenciado por documento utilizando os valores passados no parâmetro. Estes parâmetros permitem determinar a codificação, o atributo autônomo e a indentação do documento.

codificação: indica o conjunto de caracterees utilizado no documento. Por padrão (se não se llama al comando), se utiliza o conjunto de caracterees UTF-8 (Unicode comprimido).
Nota: se passar um conjunto de caracteres que não seja suportado por comandos 4D XML, será usado UTF-8. Veja Conjuntos de caracteres para uma lista dos conjuntos de caracteres suportados (entretanto na maioria dos casos é recomendado UTF-8).
autonômo (standalone): indica se o documento é autonomo (True) ou se depende, para seu funcionamento, de outros arquivos ou de recursos externos (False). Por padrão (se não for chamado o comando ou se o parâmetro for omitido), o documento não é autônomo.

Este comando deve ser chamado uma única vez por documento e antes do primeiro comando de escrita XML no documento; do contrário, se gerará uma mensagem de erro.

Nota de compatibilidade: o parâmetro indentação é conservado por razões de compatibilidade com versões anteriores de 4D mas seu uso não é recomendado a partir de 4D v12. De agora em adiante, para definir a indentação do documento, se recomenda utilizar o comando XML SET OPTIONS .

Este comando deve ser chamado apenas uma vez por documento e antes do primeiro comando de escrita XML no documento; do contrário, se gerará uma mensagem de error.

Exemplo

O código abaixo:

SAX SET XML DECLARATION($DocRef;"UTF-16";True)

... escreverá esta linha no documento:

<?xml version="1.0"Encoding="UTF-16"standalone="sim"?>

Ver também

SAX GET XML DOCUMENT VALUES