FireDAC.Comp.Client.TFDCustomConnection.Ping

De RAD Studio API Documentation
Aller à : navigation, rechercher

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;

Voir aussi