version 2004
SAX ECRIRE OPTIONS XML (document; encodage{; autonome{; indentation}})
Paramètre | Type | Description | |
document | DocRef | 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 | Vrai (défaut)=le document est indenté | |
Faux=le document n'est pas indenté |
Description
La commande SAX ECRIRE OPTIONS XML 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é.
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.
indentation : indique si le document doit faire apparaître des indentations (Vrai) ou non (Faux) correspondant aux niveaux hiérarchiques des clés XML. Par défaut (si la commande n'est pas appelée ou si le paramètre est omis), le document est indenté.
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 ECRIRE OPTIONS XML($RefDoc;"UTF-16";Vrai)
... inscrira cette ligne dans le document :
<?xml version="1.0" encoding="UTF-16" standalone="yes"?>
Référence
SAX LIRE VALEURS DOCUMENT XML.