SAX SET XML DECLARATION

4D v18


SAX SET XML DECLARATION ( documento ; codificacion {; autonomo {; indentacion}} )

Parámetro	Tipo	Descripción
documento	DocRef	Referencia del documento abierto
codificacion	Cadena	Conjunto de caracteres del documento XML
autonomo	Booleano	True = el documento es autónomo False (por defecto) = el documento no es autónomo
indentacion	Booleano	* Obsoleto no utilizar *

Descripción

El comando SAX SET XML DECLARATION inicializa el documento XML referenciado por documento utilizando los valores pasados en el parámetro. Estos parámetros permiten determinar la codificación, el atributo autónomo y la indentación del documento.

codificacion: indica el conjunto de caracteres utilizado en el documento. Por defecto (si no se llama al comando), se utiliza el conjunto de caracteres UTF-8 (Unicode comprimido).
Nota: si pasa un conjunto de caracteres que no soporta los comandos XML de 4D, se utilizará UTF-8. Consulte Conjuntos de caracteres para ver la lista de conjuntos de caracteres soportados (sin embargo se recomienda UTF-8 en la mayoría de los casos).

autonomo: indica si el documento es autonomo (True) o si depende, para su funcionamiento, de otros archivos o de recursos externos (False). Por defecto (si no se llama el comando o si el parámetro se omite), el documento no es autónomo.

Este comando debe llamarse una sola vez por documento y antes del primer comando de escritura XML en el documento; de lo contrario, se generará un mensaje de error.

Nota de compatibilidad: el parámetro indentacion se conserva por razones de compatibilidad con versiones anteriores de 4D pero su uso no se recomienda a partir de 4D v12. De ahora en adelante, para definir la indentación del documento, se recomienda utilizar el comando XML SET OPTIONS.

Este comando debe llamarse una sola vez por documento y antes del primer comando de escritura XML en el documento; de lo contrario, se generará un mensaje de error.

Ejemplo

El siguiente código:

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

... escribirá esta línea en el documento:

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

Ver también

SAX GET XML DOCUMENT VALUES