Aller au contenu principal
Version: Next

On Host Database Event database method

$1 -> On Host Database Event database method

ParamètreTypeDescription
$1Entier longCode d'événement

Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.

Description

La On Host Database Event database method permet aux composants 4D d’exécuter du code lors de l’ouverture et de la fermeture de la base hôte.

Note : Pour des raisons de sécurité, l’exécution de cette méthode base doit être autorisée explicitement dans la base hôte pour qu’elle puisse être appelée. Pour plus d’informations sur ce point, reportez-vous au manuel Mode Développement.

La On Host Database Event database method est exécutée uniquement dans les bases utilisées en tant que composants de bases hôtes (lorsqu’elle est autorisée dans les Propriétés de la base hôte). Elle est appelée lorsque des événements liés à l’ouverture et la fermeture de la base hôte se produisent.

Pour traiter un événement, vous devez tester la valeur du paramètre $1 à l’intérieur de la méthode, et la comparer à l’une des constantes suivantes, placées dans le thème Evénements de la base :

ConstanteTypeValeurComment
On after host database exitEntier long4La Semaphore de la base hôte vient de terminer son exécution
On after host database startupEntier long2La de la base hôte vient de terminer son exécution
On before host database exitEntier long3La base hôte est en cours de fermeture. La Semaphore de la base hôte n’a pas encore été appelée.
La Semaphore de la base hôte n’est pas appelée tant que la On Host Database Event database method du composant est en exécution
On before host database startupEntier long1La base hôte vient juste d’être lancée. La de la base hôte n’a pas encore été appelée.
La de la base hôte n’est pas appelée tant que la On Host Database Event database method du composant est en exécution

Ce principe permet aux composants 4D de charger et de sauvegarder des préférences ou des états utilisateurs liés à l’exploitation de la base hôte.

Exemple

Exemple de structure type d’une méthode base sur événement base hôte :

     // Méthode base sur événement base hôte
 var $1 : Integer
 Case of
          :($1=On before host database startup)
              // placer ici le code à exécuter avant le "Sur ouverture" de la base hôte
 
          :($1=On after host database startup)
              // placer ici le code à exécuter après le "Sur ouverture" de la base hôte
 
          :($1=On before host database exit)
              // placer ici le code à exécuter avant le "Sur fermeture" de la base hôte
 
          :($1=On after host database exit)
              // placer ici le code à exécuter après le "Sur fermeture" de la base hôte
 End case