4D Doc Center : ECRIRE VARIABLES

4D v14.3

ECRIRE VARIABLES


ECRIRE VARIABLES ( nomFichier ; variable {; variable2 ; ... ; variableN} )

Paramètre	Type	Description
nomFichier	Chaîne	Nom du document dans lequel sauvegarder la ou les variable(s)
variable	Variable	Variable(s) à sauvegarder

Description

La commande ECRIRE VARIABLES sauvegarde une ou plusieurs variable(s) dans un document disque dont le nom est passé dans le paramètre document.

Les variables ne doivent pas obligatoirement être du même type, mais doivent avoir le type Texte, numérique, Date, Heure, Booléen ou Image.

Si vous passez une chaîne vide ("") dans document, une boîte de dialogue standard d'enregistrement de fichiers apparaît, permettant à l'utilisateur de donner un nom au document à créer. Dans ce cas, la variable système Document récupère le nom du document, s'il a bien été créé.

Si les variables ont été correctement sauvegardées, la variable système OK prend la valeur 1. Sinon, OK prend la valeur 0.

Note : Lorsque vous écrivez des variables dans des documents à l'aide de la commande ECRIRE VARIABLES, 4D utilise un format de données qui lui est propre. Vous ne pouvez récupérer les variables qu'avec la commande LIRE VARIABLES. N'utilisez pas les commandes RECEVOIR VARIABLE ou RECEVOIR PAQUET pour lire un document créé par ECRIRE VARIABLES.

ATTENTION : La commande ECRIRE VARIABLES ne permet pas de sauvegarder les variables de type Tableau. Pour cela, vous devez utiliser les commandes du thème BLOB.

Exemple

L'exemple suivant enregistre trois variables dans un fichier nommé PrefsUti :

ECRIRE VARIABLES("PrefsUti";VSNom;VLCode;VGIconPict)

Variables et ensembles système

Si l'opération s'est correctement déroulée, la variable OK prend la valeur 1, sinon elle prend la valeur 0.