COPY NAMED SELECTION

COPY NAMED SELECTION ( {laTable ;} nom )

Paramètre	Type		Description
laTable	Table	→	Table de laquelle il faut copier la sélection ou Table par défaut si ce paramètre est omis
nom	Text	→	Nom de la sélection temporaire à créer

Description

COPY NAMED SELECTION copie la sélection courante de laTable dans une sélection temporaire nom. La table par défaut du process courant est utilisée si le paramètre optionnel laTable n'est pas spécifié. La sélection temporaire nom contient une copie de la sélection. La sélection courante et l'enregistrement courant de laTable pour le process courant ne sont pas modifiés.

Une sélection temporaire ne contient pas les enregistrements, mais une liste triée des références aux enregistrements. Chaque référence à un enregistrement prend 4 octets en mémoire. Ceci signifie que lorsqu'une sélection est copiée à l'aide de la commande COPY NAMED SELECTION, la mémoire requise est 4 octets multipliés par le nombre d'enregistrements dans la sélection. Comme les sélections temporaires restent en mémoire, il vous faut assez de mémoire pour la sélection temporaire ainsi que la sélection courante de la table pour le process.

4D Server : La sélection temporaire nom ainsi que la sélection courante sont logées dans la mémoire du poste serveur. En conséquence, assurez-vous que le serveur dispose de suffisamment de mémoire.

Utilisez la commande CLEAR NAMED SELECTION pour libérer la mémoire utilisée par nom.

Exemple

L'exemple suivant permet de vérifier s'il y a des factures impayées dans la table [Personnes]. La sélection est triée puis sauvegardée. Nous cherchons toutes les factures qui n'ont pas été payées. Ensuite, nous réutilisons la sélection et effaçons la sélection temporaire en mémoire :

 ALL RECORDS([Personnes])
  //Permettre à l'utilisateur de trier la sélection
 ORDER BY([Personnes])
  // Stocker la sélection dans une sélection temporaire
 COPY NAMED SELECTION([Personnes];"TriéeUtilisateur")
  // Rechercher les factures impayées
 QUERY([Personnes];[Personnes]FactureDue=True)
  // Si un enregistrement a été trouvé
 If(Records in selection([Personnes])>0)
  // Informer l'utilisateur
    ALERT("Oui, quelques factures n'ont pas été réglées.")
 End if
  // Réutiliser la sélection temporaire triée
 USE NAMED SELECTION("TriéeUtilisateur")
  // Effacer la sélection de la mémoire
 CLEAR NAMED SELECTION("TriéeUtilisateur")

Voir aussi

CLEAR NAMED SELECTION
CUT NAMED SELECTION
USE NAMED SELECTION

Propriétés

Numéro de commande	331
Thread safe	✓