FireDAC.Comp.Client.TFDRdbmsDataSet.OnError

• Aller au parent : TFDRdbmsDataSet

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

Un événement qui se déclenche quand une erreur se produit alors que l'ensemble de données communique avec un SGBD.

L'événement OnError se déclenche quand l'ensemble de données exécute l'une des opérations suivantes et qu'une erreur se produit :

• Prepare. L'ensemble de données prépare le texte de la commande SGBD pour l'exécution.
• Open. L'ensemble de données exécute la commande SGBD pour ouvrir le curseur.

• Execute, ExecSQL, ExecProc. L'ensemble de données exécute le texte de la commande SGBD.
• Méthodes de navigation. 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 SGBDR.
• 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.

Si AException est une instance de EFDDBArrayExecuteError, c'est un cas de gestion des erreurs Array DML.

Pour centraliser la gestion des erreurs, considérez l'utilisation de TFDCustomConnection.OnError.

Voir aussi

• FireDAC.Comp.Client.TFDCustomQuery.ExecSQL
• FireDAC.Comp.Client.TFDCustomStoredProc.ExecProc
• FireDAC.Comp.Client.TFDRdbmsDataSet.Prepare
• FireDAC.Stan.Error.EFDDBArrayExecuteError
• FireDAC.Stan.Error.EFDDBEngineException
• FireDAC.Comp.Client.TFDCustomConnection.OnError

Exemples

• Exemple FireDAC TFDQuery Batch Error Handling