FireDAC.Comp.Client.TFDConnection.OnRecover

• Aller au parent : TFDConnection

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 :

• Remplacez la valeur de AAction par faRetry.
• AAction garde la valeur faDefault et ResourceOptions.AutoReconnect vaut True.

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

• Récupération d'une connexion
• FireDAC.Comp.Client.TFDCustomConnection.OnLost
• FireDAC.Comp.Client.TFDCustomConnection.OnRestored
• FireDAC.Stan.Option.TFDTopResourceOptions.AutoReconnect
• FireDAC.Comp.Client.TFDCustomConnection.Connected
• FireDAC.Comp.Client.TFDCustomConnection.Offlined