SAX SET XML DECLARATION

4D v16.3


SAX SET XML DECLARATION ( document ; encodage {; autonome {; indentation}} )

Paramètre	Type	Description
document	RefDoc	Référence du document ouvert
encodage	Chaîne	Jeu de caractères du document XML
autonome	Booléen	Vrai=le document est autonome, Faux (défaut)=le document n’est pas autonome
indentation	Booléen	* Obsolète, ne plus utiliser *

Description

La commande SAX SET XML DECLARATION initialise le document XML référencé par document à l’aide des valeurs passées en paramètres. Ces paramètres permettent de déterminer l’encodage, l’attribut autonome (standalone) et l’indentation du document.

encodage : indique le jeu de caractères employé dans le document. Par défaut (si la commande n’est pas appelée), le jeu de caractères UTF-8 (Unicode compressé) est utilisé.
Note : Si vous passez un jeu de caractères non pris en charge par les commandes XML de 4D, l'UTF-8 sera utilisé. Reportez-vous au paragraphe Jeux de caractères pour connaître la liste des jeux de caractères pris en charge (l'UTF-8 est toutefois recommandé dans la plupart des cas).
autonome : indique si le document est autonome (Vrai) ou s’il dépend, pour son fonctionnement, d’autres fichiers ou de ressources externes (Faux). Par défaut (si la commande n’est pas appelée ou si le paramètre est omis), le document n’est pas autonome.

Note de compatibilité : Le paramètre indentation est conservé pour des raisons de compatibilité avec les versions précédentes de 4D mais son usage est déconseillé à compter de 4D v12. Désormais, pour définir l’indentation du document, il est fortement recommandé d’utiliser la commande XML SET OPTIONS.

Cette commande doit être appelée une seule fois par document et avant la première commande d’écriture XML dans le document, sinon une erreur est générée.

Exemple

Le code suivant :

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

... inscrira cette ligne dans le document :

<?xml version="1.0" encoding="UTF-16" standalone="yes"?>

Voir aussi

SAX GET XML DOCUMENT VALUES