Connection, objet (ADO)

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

Notes

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

Avec les collections, les méthodes et les propriétés d’un objet Connection, vous pouvez effectuer les opérations suivantes :

  • Configurer 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 la propriété CursorLocation sur client pour appeler le Service de curseur Microsoft pour OLE DB, qui prend en charge les mises à jour par lots.

  • Définir la base de données par défaut pour 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 arrêter ultérieurement 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.

    Notes

    Pour exécuter une requête sans utiliser d’objet Command, transmettez une chaîne de requête à la méthode Execute d’un objet Connection. Toutefois, un objet Command est requis lorsque vous souhaitez conserver le texte de la commande et réexécuter celle-ci, ou utiliser des paramètres de requête.

  • Gérez les transactions sur la connexion ouverte, y compris les transactions imbriquées si le fournisseur les prend en charge, avec les méthodes BeginTrans, CommitTrans et RollbackTrans, ainsi que la propriété Attributes .

  • Examinez les erreurs retournées à partir de la source de données avec la collection Errors.

  • Lisez la version de l’implémentation ADO utilisée avec la propriété Version.

  • Obtenez des informations de schéma sur votre base de données avec la méthode OpenSchema.

Vous pouvez créer des objets Connection indépendamment de n’importe quel autre objet précédemment défini.

Vous pouvez exécuter des commandes nommées ou des procédures stockées comme s’il s’agissait de méthodes natives sur un objet Connection, comme indiqué dans la section suivante. Quand une commande nommée porte le même nom qu’une procédure stockée, un « appel de méthode native » sur un objet Connection exécute toujours la commande nommée au lieu de la procédure stockée.

Notes

N’utilisez pas cette fonctionnalité (appel de commande nommée ou de procédure stockée comme s’il s’agissait d’une méthode native sur l’objet Connection) dans une application Microsoft® .NET Framework, car l’implémentation sous-jacente de la fonctionnalité est en conflit avec la façon dont le .NET Framework interopère avec COM.

Exécuter une commande en tant que méthode native d’un objet Connection

Pour exécuter une commande, nommez-la en utilisant la propriété Command de l’objet Name. Définissez la propriété ActiveConnection de l’objet Command sur la connexion. Émettez ensuite une instruction dans laquelle le nom de la commande est utilisé comme s’il s’agissait d’une méthode sur l’objet Connection, suivie de tous les paramètres et d’un objet Recordset si des lignes sont retournées. Définissez les propriétés d’objet Recordset pour 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. "parameter", rst  

Exécuter une procédure stockée en tant que 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 sur l’objet Connection, suivie de tous les paramètres. ADO fera une « meilleure hypothèse » des types de paramètres. Par exemple :

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

L’objet Connection est sécurisé pour le script.

Cette section contient la rubrique suivante.

Voir aussi

Command, objet (ADO)
Errors, collection (ADO)
Properties, collection (ADO)
Recordset, objet (ADO)
Annexe A : Fournisseurs