Saltar para o conteúdo principal
Versão: Próximo

SAX SET XML DECLARATION

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

ParâmetroTipoDescrição
documentoTimeReferência do documento aberto
codificaçaoTextConjunto de caracteres usado no documento XML
autonomoBooleanTrue= o documento é autônomo (standalone); False (padrão) = documento não é standalone

Descrição

O comando SAX SET XML DECLARATION inicializa o documento XML referenciado por documento utilizando a codificação especificada. Opcionalmente, pode estabelecer o atributo standalone/autônomo.

  • 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.

Nota: Pode especificar a indentação do documento graças ao comando XML SET OPTIONS antes de escrever qualquer coisa.

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.

Exemplo

O código abaixo:

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

... escreverá esta linha no documento:

 

Ver também

SAX GET XML DOCUMENT VALUES