FireDAC.Stan.Option.TFDResourceOptions.CmdExecMode
Delphi
property CmdExecMode: TFDStanAsyncMode read GetCmdExecMode
C++
__property Firedac::Stan::Intf::TFDStanAsyncMode CmdExecMode = {read=GetCmdExecMode, write=SetCmdExecMode, stored=IsCEMS, default=0};
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
property | published | FireDAC.Stan.Option.pas FireDAC.Stan.Option.hpp |
FireDAC.Stan.Option | TFDResourceOptions |
Description
Contrôle le mode d'exécution de l'action du SGBD.
Utilisez la propriété CmdExecMode pour contrôler le mode d'exécution de l'action du SGBD, d'abord son synchronisme :
Mode |
Description |
|
Le thread appelant et le GUI sont bloqués jusqu'à ce qu'une action soit terminée. |
|
Le thread appelant est bloqué jusqu'à ce qu'une action soit terminée. Le GUI n'est pas bloqué. |
|
Le thread appelant et le GUI sont bloqués jusqu'à ce qu'une action soit terminée. FireDAC affiche le dialogue permettant l'annulation d'une action. |
|
Le thread appelant et le GUI ne sont pas bloqués. La méthode appelée renvoie une valeur immédiatement. |
La valeur par défaut est amBlocking
. Cette propriété contrôle le synchronisme des méthodes suivantes :
- TFDDataSet.Open, TFDCustomCommand.Open
- TFDDataSet.Execute, TFDCustomCommand.Execute
- Lire dans TFDDataSet, TFDCustomCommand.Fetch
Si le mode est amNonBlocking
, l'application continue à traiter les messages GUI, mais elle ignore les événements de clavier et de souris.
Si le mode est amCancelDialog
, l'application doit inclure le composant TFDGUIxAsyncExecuteDialog dans toute fiche ou module de données. S'il n'est pas inclus, une exception est déclenchée.
Le bouton Annuler du dialogue permet de terminer l'action en cours. Si le SGBD ne permet pas l'annulation d'une action, le bouton sera caché.
Si le mode est amAsync
, l'application peut recevoir une notification de la terminaison de l'action en utilisant le gestionnaire d’événement ou le rappel approprié.
Classe |
Méthode |
Evénement |
TFDDataSet |
Open |
Evénement AfterOpen |
|
Execute |
Evénement AfterExecute |
TFDCustomCommand |
Open |
Evénement AfterOpen |
|
Execute |
Evénement AfterExecute |
|
Fetch |
Evénement AfterFetch |
L'application peut contrôler le délai d'attente de l'action en définissant la propriété CmdExecTimeout.