Connection (gb.db)

Cette classe représente une connexion à une base de données.

Pour se connecter à une base de données, créer un objet de connexion, remplir les propriétés nécessaires, et appeler la Méthode Open.

Cette classe hérite _Connection.

Cette classe est instanciable.

Propriétés
Options   Return or set the connection options.
SQL  
Url  

Propriétés héritées
Charset   Retourne l'encodage utilisé par la base de données.
Collations  
Databases   Retourne une collection de toutes les bases de données gérées par le serveur de base de données.
Error   Retourne le dernier code d'erreur déclenché par le pilote de la base de données.
FullVersion  
Handle  
Host   Retourne ou définit l'hôte ou le serveur de la base données réside.
IgnoreCharset  
LastInsertId  
Login   Retourne ou définit l’utilisateur employé pour établir la connexion.
Name   Retourne ou définit le nom de la base de données auquel vous souhaitez vous connecter.
Opened   Retourne si la connexion est ouverte.
Password   Retourne ou définit le mot de passe utilisé pour établir la connexion.
Port   Retourne ou définit le port TCP/IP utilisé pour établir la connexion.
Tables   Retourne une collection virtuel pour gérer les tables de la base de données.
Timeout   Retourne ou établit le délai de réponse de la connexion en secondes.
Type   Représente le type de serveur de base de données auquel vous voulez vous connecter.
User   Un synonyme pour la propriété Login.
Users   Retourne une collection de tout les utilisateurs enregistrés dans le serveur de base de données.
Version   Retourne la version de la base de données à laquelle le pilote est connecté.

Méthodes
ApplyTemplate  
Copy  
GetTemplate  

Méthodes héritées
Begin   Débute une transaction.
Close   Ferme la connexion.
Commit   Soumet une transaction.
Create   Retourne un objet en lecture/écriture Result, utilisé pour créer des enregistrements dans la table specifiée .
Delete   Retire des enregistrements d’une table de base de données.
Edit   Retourne un objet Result en lecture/écriture utilisé pour éditer les enregistrements de la table spécifiée.
Exec   Exécute une requête SQL arbitraire, et retourne un résultat en lecture-seule contenant le résultat de la requête.
Find   Retourne un objet Result en lecture/écriture utilisé pour interroger des enregistrement dans la table spécifiée.
FormatBlob  
Limit   Limite le nombre d'enregistrements retournés par la prochaîne demande.
Open   Ouvre la connexion à la base de données.
Quote   Retourne un identificateur mis "entre quotes" de manière à ce que vous puissiez librement l’insérer dans une requête.
Rollback   Annule une transaction.
Subst   Crée une phrase SQL en substituant ses arguments dans une chaîne format.

Pour les connexions SQLite, l'algorithme suivant est utilisé:

  • Si Name est null, une base de données en mémoire est ouverte.

  • Si Name est un chemin absolu, alors ce chemin est utilisé.

  • Si Name est un chemin relatif, alors:
    • Si Host est nul, alors la base de données est localisée dans le répertoire temporaire de l'application. Voir Temp$() pour plus d'informations.

    • Autrement, Host donne le répertoire de la base de données, et le chemin de la base de données est le résultat de la concaténation de Host et Name.

Voir aussi