InterBase ToGo mit dbExpress

Nach oben zu Datenbankanwendungen entwickeln

Ab XE3 unterstützt RAD Studio InterBase ToGo-Datenbanken.

Änderungen

Ab XE3 wurde in RAD Studio das dbExpress-Framework durch Hinzufügen eines InterBase ToGo-spezifischen Treibers erweitert. Durch diese Änderung können Benutzer Verbindungen mit InterBase ToGo-Datenbanken in Delphi- und C++-Anwendungen über dbExpress einfacher einrichten.

Verwenden des InterBase ToGo-Treibers

Der InterBase ToGo-Treiber kann nur zur Laufzeit verwendet werden.

Wenn Sie beim Entwurf eine Verbindung mit InterBase ToGo aktivieren oder im Daten-Explorer eine geöffnete InterBase ToGo-Verbindung vorhanden ist und Sie versuchen, die Anwendung auszuführen, erhalten Sie einen Laufzeitfehler. Und zwar, weil für die InterBase ToGo-Serverlizenz der exklusive Zugriff auf die Datenbank erforderlich ist. Da beim Entwurf bereits eine Verbindung geöffnet ist, können Sie in der Anwendung, die Sie erzeugen/ausführen, keine lokale Verbindung zu derselben Datenbank öffnen. InterBase ToGo ist nur als Bereitstellungsoption gedacht und sollte nicht in der IDE oder im Daten-Explorer verwendet werden.

Verwenden Sie deshalb beim Entwurf und im Daten-Explorer die Vollversion des InterBase-Clients.

Beispiel

Das folgende Beispiel ist ein Tutorial zum Einrichten einer Verbindung mit einer InterBase ToGo-Datenbank in einer Delphi-VCL-Formularanwendung:

Schritte

1. Wählen Sie Datei > Neu > VCL-Formularanwendung - Delphi.
2. Fügen Sie dem Formular die folgenden Komponenten hinzu:
   • Ein TButton-Steuerelement; setzen Sie im Objektinspektor die Eigenschaft Name der Schaltfläche auf connectButton und die Eigenschaft Caption auf Connect.
   • Ein TSQLConnection-Steuerelement.
   • Ein TMemo-Steuerelement; setzen Sie im Objektinspektor die Eigenschaft Name auf outputMemo.
3. Fügen Sie der OnClick-Ereignisbehandlungsroutine für connectButton den folgenden Code hinzu.

procedure TForm1.connectButtonClick(Sender: TObject);
 begin
   // create a new TSQLConnection object
   SQLConnection1 := TSQLConnection.Create(nil);
   // set the driver of the TSQLConnection control
   SQLConnection1.DriverName := 'IBToGo';
   // add the Database parameter to Params
   SQLConnection1.Params.Add('Database=full_path_to_your_database_file');
   // set the Username and Password parameters
   SQLConnection1.Params.Add('User_Name=SYSDBA');
   SQLConnection1.Params.Add('Password=masterkey');
   try
     // open the connection
     SQLConnection1.Open;
     Memo1.Text := 'Connection established';
   except
     on E: Exception do
       Memo1.Text := 'Exception raised with message : ' + #13#10 + E.Message;
   end;
 end;

Siehe auch

• InterBase ToGo
• Mobile-Tutorial: Verwenden von InterBase ToGo mit dbExpress (iOS und Android)
• InterBase 2020 ToGo Quick Start Guide
• Data.SqlExpr.TSQLConnection
• Vcl.StdCtrls.TButton
• Vcl.StdCtrls.TMemo
• Vcl.Controls.TControl.OnClick
• Objektinspektor
• System.Classes.TComponent.Name
• Vcl.StdCtrls.TButton.Caption
• Daten-Explorer
• InterBase