version 5
CHARGER ENSEMBLE ({table; }ensemble; document)
Paramètre | Type | Description | |
table | Table | Table à laquelle appartient l'ensemble ou | |
Table par défaut si ce paramètre est omis | |||
ensemble | Alpha | Nom de l'ensemble à créer en mémoire | |
document | Alpha | Document disque contenant l'ensemble |
Description
CHARGER ENSEMBLE charge un ensemble depuis le fichier document, créé à l'aide de la commande STOCKER ENSEMBLE.
L'ensemble stocké dans document doit s'appliquer à table. Si ensemble existait déjà en mémoire, il est réécrit.
Le paramètre document est le nom du fichier disque contenant l'ensemble. Il n'est pas nécessaire que ce fichier ait le même nom que l'ensemble. Si vous passez une chaîne vide dans document, une boîte de dialogue standard d'ouverture de fichiers s'affiche, permettant à l'utilisateur de choisir l'ensemble à charger.
ATTENTION : Rappelez-vous qu'un ensemble est l'image d'une sélection d'enregistrements au moment précis où l'ensemble est créé. Si les enregistrements représentés par l'ensemble sont modifiés, celui-ci devient obsolète. En conséquence, vous devez stocker et charger des ensembles avec des enregistrements dont le contenu varie peu. De multiples événements peuvent rendre un ensemble obsolète : modification ou suppression d'un enregistrement de l'ensemble, ou encore modification des critères ayant déterminé la création de l'ensemble.
Exemple
L'exemple suivant utilise CHARGER ENSEMBLE pour charger l'ensemble des locaux de l'entreprise Dupont SARL à Paris :
` Charger l'ensemble en mémoire CHARGER ENSEMBLE ([Entreprises]; "Paris Dupont SARL"; "PaDupontEns") UTILISER ENSEMBLE ("Paris Dupont SARL") ` Modifier la sélection courante avec l'ensemble EFFACER ENSEMBLE ("Paris Dupont SARL") ` Effacer l'ensemble de la mémoire
Référence
Variables et ensembles système
Si l'utilisateur clique sur Annuler dans la boîte de dialogue d'ouverture de fichiers, ou si une erreur se produit pendant le chargement, la variable système OK prend la valeur 0. Sinon, elle prend la valeur 1.