FireDAC.Comp.Client.TFDConnection.OnRecover

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property OnRecover: TFDConnectionRecoverEvent read FOnRecover write FOnRecover;

C++

__property OnRecover;

Propriétés

Type Visibilité  Source Unité  Parent
event published
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDConnection

Description

Se produit lorsque la connexion au SGBD est perdue.

FireDAC.Comp.Client.TFDConnection.OnRecover hérite de FireDAC.Comp.Client.TFDCustomConnection.OnRecover. Tout le contenu en-dessous de cette ligne se réfère à FireDAC.Comp.Client.TFDCustomConnection.OnRecover.

Se produit lorsque la connexion au SGBD est perdue.

Le gestionnaire d'événement de OnRecover reçoit les paramètres suivants :

  • ASender est la connexion.
  • AInitiator est l'objet qui découvre que la connexion a été perdue.
  • AException est l'exception qui décrit le problème survenu.
  • AAction détermine l'action à entreprendre par FireDAC pour traiter le problème.

Vous pouvez gérer OnRecover de façon à analyser la cause du problème et déterminer comment FireDAC doit traiter le problème. Pour déterminer comment FireDAC doit traiter le problème, modifiez la valeur de AAction par l'une des valeurs suivantes :

Action Description

faDefault
(par défaut)

Si ResourceOptions.AutoReconnect vaut True, tentez une nouvelle connexion.
Si ResourceOptions.AutoReconnect vaut False (par défaut), fermez la connexion et déclenchez AException.

faFail

Ferme la connexion et déclenche AException.

faRetry

Essaie de rétablir la connexion.

faCloseAbort

Ferme la connexion et abandonne l'opération en cours.

faOfflineAbort

Bascule la connexion en mode hors ligne et abandonne l'opération en cours.

Pour que FireDAC tente à nouveau d'établir la connexion, effectuez l'une des actions suivantes :

Si vous avez demandé à FireDAC de tenter à nouveau la connexion, il effectue jusqu'à trois tentatives. Si après trois tentatives la connexion n'est pas rétablie, FireDAC ferme alors la connexion et déclenche AException.

Voir aussi