FireDAC.Comp.Client.TFDCustomConnection.Ping
Delphi
function Ping: Boolean;
C++
bool __fastcall Ping();
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomConnection |
Beschreibung
Überprüft, ob eine Verbindung mit dem DBMS-Server besteht.
Die Methode Ping überprüft, ob eine Verbindung mit einem DBMS-Server besteht. Wenn die Verbindung nicht besteht und ResourceOptions.AutoReconnect True ist, wird eine automatische Neuverbindung versucht.
Wenn eine Verbindung inaktiv ist, versucht die Methode Ping, eine Verbindung zu öffnen.
Anhand dieser Funktion können Clients, die lange im Ruhezustand verbleiben oder in instabilen Umgebungen ausgeführt werden (z. B. schlechte Netzwerkverbindung), überprüfen, ob der Server die Verbindung geschlossen hat oder ob auf den Server nicht zugegriffen werden kann, und bei Bedarf die Verbindung erneut herstellen. Falls auf den Server zugegriffen werden kann, kann mit dieser Funktion eine Verbindung geöffnet werden.
Ping gibt True zurück, wenn die Verbindung zum DBMS funktionsfähig ist.
Beispiel
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;