Configuration d'une connexion TSQL

De RAD Studio (Français)

Remonter à Comment exécuter les procédures de bases de données

La première étape du travail avec un ensemble de données unidirectionnel est de se connecter à un serveur de base de données. A la conception, une fois qu'un ensemble de données dispose d'une connexion active à un serveur de base de données, l'inspecteur d'objets peut fournir des listes déroulantes de valeurs pour les autres propriétés. Par exemple, s'il s'agit d'une procédure stockée, il faut qu'une connexion soit active pour que l'inspecteur d'objets puisse indiquer les procédures stockées disponibles sur le serveur. La connexion à un serveur de base de données est représentée par un composant TSQLConnection distinct. Vous utilisez TSQLConnection comme tout autre composant connexion de base de données.

Métaprocédure : Configuration d'une connexion TSQL

  1. Choisissez Fichier > Nouveau > Autre.La boîte de dialogue Nouveaux éléments apparaît.
  2. Dans la boîte de dialogue Nouveaux éléments, sélectionnez Projets Delphi, puis double-cliquez sur Application Fiches VCL.Le concepteur Windows s'affiche.
  3. A partir de la catégorie dbExpress de la palette d'outils, faites glisser un composant TSQLConnection sur la fiche.
  4. Identifiez le pilote (voir les étapes ci-dessous).
  5. Spécifiez les paramètres de connexion (voir les étapes ci-dessous).
  6. Identifiez une connexion de base de données (voir les étapes ci-dessous).
  7. Affichez et utilisez l'éditeur de connexion dbExpress (voir les étapes ci-dessous).

Pour identifier le pilote

  1. Sélectionnez le composant TSQLConnection.
  2. Dans l'inspecteur d'objets, définissez la propriété DriverName sur un pilote dbExpress installé.
  3. Identifiez les fichiers associés au nom du pilote. Sélectionnez un des éléments suivants :
    • Le pilote dbExpress
    • La bibliothèque de liaison dynamique
Remarque :  La relation entre le pilote dbExpress ou la bibliothèque de liaison dynamique et le nom de la base de données est stockée dans un fichier appelé dbxdrivers.ini, qui est mis à jour lorsque vous installez un pilote dbExpress. Le composant connexion SQL recherche le pilote dbExpress et la bibliothèque de liaison dynamique dans dbxdrivers.ini lorsqu'il reçoit la valeur de DriverName. Lorsque vous définissez la propriété DriverName, TSQLConnection attribue automatiquement aux propriétés LibraryName et VendorLib les noms des dll associées. Une fois LibraryName et VendorLib définies, votre application n'est plus dépendante de dbxdrivers.ini.

Pour spécifier un paramètre de connexion

  1. Double-cliquez sur la propriété Params dans l'inspecteur d'objets pour modifier les paramètres en utilisant l'éditeur de liste de valeurs au moment de la conception.
  2. Utilisez la propriété Params.Values pour affecter des valeurs à des paramètres individuels au moment de l'exécution.

Pour identifier une connexion de base de données

  1. Initialisez la propriété ConnectionName avec un nom de connexion valide. Cela initialise automatiquement les propriétés DriverName et Params.
  2. Modifiez la propriété Params pour modifier l'ensemble de valeurs de paramètres enregistré.
  3. Initialisez la propriété LoadParamsOnConnect à True pour développer votre application en utilisant une base de données et la déployer en utilisant une autre.Cela provoque l'initialisation automatique par TSQLConnection de DriverName et Params aux valeurs associées à ConnectionName dans dbxconnections.ini lorsque la connexion est ouverte.
  4. Appelez la méthode LoadParamsFromIniFile. Cette méthode initialise DriverName et Params aux valeurs associées à ConnectionName dans dbxconnections.ini (ou dans un autre fichier que vous spécifiez). Vous pouvez opter pour cette méthode si vous souhaitez remplacer certaines valeurs de paramètres avant d'ouvrir la connexion.

Pour afficher l'éditeur de connexion

  1. Double-cliquez sur le composant TSQLConnection.L'éditeur de connexion dbExpress apparaît, avec une liste déroulante des pilotes, une liste de noms de connexion pour le pilote sélectionné et un tableau des paramètres de connexion pour le nom de connexion sélectionné.
  2. Dans la liste déroulante Nom du pilote, sélectionnez un pilote pour indiquer la connexion à utiliser.
  3. Dans la liste Nom de connexion, sélectionnez nom de connexion.
  4. Choisissez la configuration voulue.
  5. Cliquez sur le bouton Tester la connexion pour vérifier si la configuration est valide.

Pour définir et modifier des connexions en utilisant l'éditeur de connexion

  1. Pour modifier les connexions nommées actuellement sélectionnées dans dbxconnections.ini, modifiez les valeurs des paramètres dans la table des paramètres.
  2. Cliquez sur OK.Les nouvelles valeurs de paramètres sont enregistrées dans dbxconnections.ini.
  3. Cliquez sur le bouton Ajouter une connexion pour définir une nouvelle connexion.La boîte de dialogue Nouvelle connexion apparaît.
  4. Dans la boîte de dialogue Nouvelle connexion, définissez Nom de pilote et Nom de connexion.
  5. Cliquez sur OK.
  6. Cliquez sur le bouton Supprimer la connexion pour supprimer la connexion nommée actuellement sélectionnée de dbxconnections.ini.
  7. Cliquez sur le bouton Renommer la connexion pour modifier le nom de la connexion nommée sélectionnée.

Voir aussi

Récupérée de « http://docwiki.embarcadero.com/RADStudio/2010/f/index.php?title=Configuration_d%27une_connexion_TSQL&oldid=83720 »
Autres langues