API:FireDAC.Comp.Client.TFDRdbmsDataSet.OnError
Delphi
property OnError: TFDErrorEvent read GetOnError write SetOnError;
C++
__property Firedac::Stan::Error::TFDErrorEvent OnError = {read=GetOnError, write=SetOnError};
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
event | public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDRdbmsDataSet |
Description
L'événement est déclenché quand une erreur est générée, alors que l'ensemble de données communique avec le SGBD.
FireDAC.Comp.Client.TFDRdbmsDataSet.OnError hérite de FireDAC.Comp.Client.TFDAdaptedDataSet.OnError. Tout le contenu en-dessous de cette ligne se réfère à FireDAC.Comp.Client.TFDAdaptedDataSet.OnError.
L'événement est déclenché quand une erreur est générée, alors que l'ensemble de données communique avec le SGBD.
L'événement OnError est déclenché quand l'ensemble de données exécute l'une des opérations d'ensemble de données suivantes et qu'une erreur est générée :
- Prepare. L'ensemble de données prépare la commande SGBD pour l'exécution.
- Open. L'ensemble de données exécute la commande SGBD pour ouvrir le curseur.
- ExecSQL/ExecProc/Execute. L'ensemble de données exécute la commande SGBD.
Fetch
. L'ensemble de données récupère les lignes du curseur.
Le gestionnaire d'événement de OnError reçoit les paramètres suivants :
ASender
est l'ensemble de données adapté.AInitiator
est l'objet qui déclenche l'exception.AException
est l'exception. C'est généralement une instance de EFDDBEngineException.
Vous pouvez gérer OnError pour analyser et modifier l'objet exception. Vous pouvez même créer un nouvel objet exception et l'assigner à AException
. Dans ce cas, vous devez libérer l'objet exception original.
Vous pouvez aussi utiliser l'événement OnExecuteError pour gérer les erreurs Array DML, et l'événement OnUpdateError pour gérer les erreurs de postage des mises à jour.