4D Doc Center : CHARGER ENSEMBLE

4D v14.3

CHARGER ENSEMBLE


CHARGER ENSEMBLE ( {laTable ;} ensemble ; nomFichier )

Paramètre	Type	Description
laTable	Table	Table à laquelle appartient l'ensemble ou Table par défaut si ce paramètre est omis
ensemble	Chaîne	Nom de l'ensemble à créer en mémoire
nomFichier	Chaîne	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 à laTable. 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

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.