version 5
ECRIRE VARIABLES (doc; variable{; variable2; ...; variableN})
Paramètre | Type | Description | |
doc | Alpha | 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 doc.
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 doc, 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.
Référence
BLOB VERS DOCUMENT, BLOB VERS VARIABLE, DOCUMENT VERS BLOB, LIRE VARIABLES, VARIABLE VERS BLOB, Variables système.