FireDAC.Comp.Client.TFDCustomConnection.Ping
Delphi
function Ping: Boolean;
C++
bool __fastcall Ping(void);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomConnection |
Description
Effectue un test ping sur le serveur SGBD.
La méthode Ping vérifie si une connexion à un serveur SGBD est en vie. Quand la connexion est morte et que ResourceOptions.AutoReconnect est défini sur True, une reconnexion est automatiquement tentée.
Quand une connexion est inactive, la méthode Ping essaie d'ouvrir une connexion.
Cette fonction peut être utilisée par les clients qui restent inactifs pendant un long moment ou travaillent dans des environnements instables (par exemple, une mauvaise connexion réseau) pour vérifier si le serveur a fermé la connexion ou est inaccessible, et effectuer une reconnexion si nécessaire, ou si le serveur est accessible pour ouvrir une connexion.
Ping renvoie True si la connexion au SGBD fonctionne.
Exemple
procedure TMyDataModule.DoPing(ASender: TObject);
begin
if not FDConnection1.Ping then
ShowMessage('Connection is lost!');
end;
.......
FTimer := TTimer.Create;
FTimer.OnTimer := DoPing;
FTimer.Interval := 30000; // each 30 secs
FTimer.Enabled := True;