Partager via

Objet Connection (ADO)

  • Article

S’applique à : Access 2013, Office 2013

Représente une connexion ouverte à une source de données.

Remarques

Un objet Connection représente une session unique avec une source de données. Dans le cas d'un système de base de données client/serveur, il peut être équivalent à une connexion réseau réelle au serveur. Selon les fonctionnalités prises en charge par le fournisseur, certaines collections, méthodes ou propriétés d'un objet Connection risquent de ne pas être disponibles.

Les collections, les méthodes et les propriétés d'un objet Connection vous permettent d'effectuer diverses tâches :

  • Configurez la connexion avant de l’ouvrir avec les propriétés ConnectionString, ConnectionTimeout et Mode . ConnectionString est la propriété par défaut de l’objet Connection .

  • définir le client comme valeur de la propriété CursorLocation pour appeler Service de curseur Microsoft pour OLE DB (composant du service ADO), qui prend en charge les mises à jour par lot ;

  • définir la base de données par défaut de la connexion avec la propriété DefaultDatabase ;

  • définir le niveau d'isolation des transactions ouvertes sur la connexion avec la propriété IsolationLevel ;

  • spécifier un fournisseur OLE DB avec la propriété Provider ;

  • établir (et ultérieurement rompre) la connexion physique à la source de données avec les méthodes Open et Close ;

  • exécuter une commande sur la connexion avec la méthode Execute et configurer l'exécution avec la propriété CommandTimeout ;

    Remarque

    [!REMARQUE] Pour exécuter une requête sans utiliser d'objet Command, passez une chaîne de requête à la méthode Execute d'un objet Connection. Toutefois, un objet Command est nécessaire si vous voulez rendre persistant le texte de commande et l'exécuter de nouveau, ou utiliser des paramètres de requête.

  • gérer des transactions sur une connexion ouverte, notamment des transactions imbriquées si le fournisseur les prend en charge, avec les méthodes BeginTrans, CommitTrans et RollbackTrans, ainsi qu'avec la propriété Attributes ;

  • examiner les erreurs renvoyées par la source de données à l'aide de la collection Errors ;

  • lire la version de l'implémentation ADO utilisée avec la propriété Version ;

  • obtenir des informations de schéma sur votre base de données au moyen de la méthode OpenSchema.

Vous pouvez créer des objets Connection indépendamment de tout autre objet défini précédemment.

Vous pouvez exécuter des commandes ou des procédures stockées comme si celles-ci étaient des méthodes natives de l'objet Connection (voir exemples ci-dessous).

Exécuter une commande comme une méthode native d'un objet Connection

Pour exécuter une commande, donnez-lui un nom à l'aide de la propriété Name de l'objet Command. Attribuez à la propriété ActiveConnection de l'objet Command le nom de la connexion. Émettez ensuite une instruction dans laquelle le nom de la commande est utilisé comme s'il s'agissait d'une méthode de l'objet Connection, suivie d'éventuels paramètres et ensuite d'un objet Recordset si des lignes sont renvoyées. Définissez les propriétés de Recordset de façon à personnaliser l'objet Recordset obtenu. Par exemple :

    Dim cnn As New ADODB.Connection
    Dim cmd As New ADODB.Command
    Dim rst As New ADODB.Recordset
    ...
    cnn.Open "..."
    cmd.Name = "yourCommandName"
    cmd.ActiveConnection = cnn
    ...
    'Your command name, any parameters, and an optional Recordset.
    cnn.yourCommandName "parameter", rst

Exécuter une procédure stockée comme une méthode native d'un objet Connection

Pour exécuter une procédure stockée, émettez une instruction dans laquelle le nom de la procédure stockée est utilisé comme s'il s'agissait d'une méthode de l'objet Connection, suivie d'éventuels paramètres. ADO détermine du mieux qu'il peut les types des paramètres. Par exemple :

    Dim cnn As New ADODB.Connection
    ...
    'Your stored procedure name and any parameters.
    cnn.sp_yourStoredProcedureName "parameter"