TSQLConnection konfigurieren

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu DbExpress verwenden


Der erste Schritt bei der Arbeit mit einer unidirektionalen Datenmenge ist, sie mit einem Datenbankserver zu verbinden. Nachdem eine Datenmenge über eine aktive Verbindung zu einem Datenbankserver verfügt, kann der Objektinspektor zur Entwurfszeit Dropdown-Listen mit Werten für andere Eigenschaften bereitstellen. Beispielsweise benötigen Sie für die Darstellung einer Stored Procedure eine aktive Verbindung, damit der Objektinspektor die Stored Procedures auflisten kann, die auf dem Server zur Verfügung stehen. Die Verbindung zu einem Datenbankserver wird durch eine separate TSQLConnection-Komponente dargestellt. TSQLConnection kann wie jede andere Datenbankverbindungskomponente verwendet werden.

Allgemeine Anleitung: Eine TSQLConnection konfigurieren

  1. Wählen Sie Datei > Neu > Weitere. Das Dialogfeld Objektgalerie wird geöffnet.
  2. Wählen Sie im Dialogfeld Objektgalerie die Kategorie Delphi-Projekte, und doppelklicken Sie dann auf VCL-Formularanwendung. Der Designer wird angezeigt.
  3. Ziehen Sie aus der Seite dbExpress der Tool-Palette eine TSQLConnection-Komponente in das Formular.
  4. Legen Sie den Treiber fest (siehe die folgenden Schritte).
  5. Geben Sie die Verbindungsparameter an (siehe die folgenden Schritte).
  6. Legen Sie die Datenbankverbindung fest (siehe die folgenden Schritte).
  7. Öffnen Sie den dbExpress-Verbindungseditor für die weitere Arbeit (siehe die folgenden Schritte).

So legen Sie den Treiber fest:

  1. Wählen Sie die TSQLConnection-Komponente aus.
  2. Setzen Sie im Objektinspektor die Eigenschaft DriverName mithilfe des Kombinationsfelds, das alle Treibernamen enthält, auf einen installierten dbExpress-Treiber.
  3. Geben Sie die Dateien an, die mit dem Treibernamen verknüpft sind. Sie haben folgende Auswahlmöglichkeiten:
    • dbExpress-Treiber
    • Dynamische Linkbibliothek

Hinweis: Die Beziehung zwischen dem dbExpress-Treiber bzw. der dynamischen Linkbibliothek und dem Datenbanknamen wird in der Datei dbxdrivers.ini gespeichert, die bei der Installation eines dbExpress-Treibers aktualisiert wird. Die SQL-Verbindungskomponente sucht den dbExpress-Treiber und die dynamische Linkbibliothek in der Datei dbxdrivers.ini, wenn der Wert von DriverName angegeben ist. Wenn Sie die Eigenschaft DriverName festlegen, setzt TSQLConnection automatisch die Eigenschaften LibraryName und VendorLib auf die Namen der zugehörigen DLLs. Nachdem LibraryName und VendorLib gesetzt wurden, muss die Anwendung nicht mehr auf dbxdrivers.ini zugreifen.

So definieren Sie einen Verbindungsparameter:

  1. Doppelklicken Sie im Objektinspektor auf die Eigenschaft Params, um die Parameter mit dem Wertelisten-Editor zur Entwurfszeit zu bearbeiten.
  2. Mit Hilfe der Eigenschaft Params.Values können Sie zur Laufzeit einzelnen Parametern Werte zuweisen.

So legen Sie eine Datenbankverbindung fest:

  1. Setzen Sie die Eigenschaft ConnectionName auf einen gültigen Verbindungsnamen. Dadurch werden die Eigenschaften DriverName und Params automatisch gesetzt.
  2. Ändern Sie gespeicherten Parameterwerte der Eigenschaft Params.
  3. Setzen Sie die Eigenschaft LoadParamsOnConnect auf True, um Ihre Anwendung mit einer Datenbank zu entwickeln und mit einer anderen weiterzugeben. Dadurch wird TSQLConnection veranlasst, die Eigenschaften DriverName und Params automatisch auf die Werte zu setzen, die der Eigenschaft ConnectionName in der Datei dbxconnections.ini beim Öffnen der Verbindung zugeordnet wurden.
  4. Rufen Sie die Methode LoadParamsFromIniFile auf. Diese Methode setzt DriverName und Params auf die ConnectionName in dbxconnections.ini (oder in einer anderen Datei, die Sie angeben) zugeordneten Werte. Verwenden Sie diese Methode beispielsweise, wenn Sie bestimmte Parameterwerte überschreiben wollen, bevor Sie die Verbindung öffnen.

So zeigen Sie den Verbindungseditor an:

  1. Doppelklicken Sie auf die TSQLConnection-Komponente. Der dbExpress-Verbindungseditor wird angezeigt und stellt eine Dropdown-Liste mit Treibern, eine Liste der Verbindungsnamen für den ausgewählten Treiber sowie eine Tabelle mit den Verbindungsparametern für den ausgewählten Verbindungsnamen bereit.
  2. Wählen Sie in der Dropdown-Liste Treibername einen Treiber aus, um die zu verwendende Verbindung anzugeben.
  3. Wählen Sie in der Liste Name der Verbindung einen Verbindungsnamen aus.
  4. Wählen Sie die gewünschte Konfiguration aus.
  5. Klicken Sie auf die Schaltfläche Verbindung testen, um sicherzustellen, dass Sie eine gültige Konfiguration ausgewählt haben.

So definieren und ändern Sie Verbindungen mit dem Verbindungseditor:

  1. Wenn Sie die aktuell in der Datei dbxconnections.ini ausgewählten benannten Verbindungen ändern möchten, bearbeiten Sie die Parameterwerte in der Parametertabelle.
  2. Klicken Sie auf OK. Die neuen Parameterwerte werden in dbxconnections.ini gespeichert.
  3. Klicken Sie auf die Schaltfläche Verbindung hinzufügen, um eine neue Verbindung zu definieren. Das Dialogfeld Neue Verbindung wird geöffnet.
  4. Geben Sie im Dialogfeld Neue Verbindung den Treibernamen und den Namen der Verbindung an.
  5. Klicken Sie auf OK.
  6. Klicken Sie auf die Schaltfläche Verbindung löschen, um die aktuell ausgewählte benannte Verbindung aus dbxconnections.ini zu entfernen.
  7. Klicken Sie auf die Schaltfläche Verbindung umbenennen, um den Namen der aktuell ausgewählten benannten Verbindung zu ändern.

Siehe auch