Partage via

Connection, objet (ADO)

  • Article

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 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 peuvent ne pas être disponibles.

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

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

  • Définissez la propriété CursorLocation sur le client pour appeler le service de curseur Microsoft pour OLE DB, qui prend en charge les mises à jour par lots.

  • Définissez la base de données par défaut pour la connexion avec la propriété DefaultDatabase.

  • Définissez le niveau d’isolation des transactions ouvertes sur la connexion avec la propriété IsolationLevel.

  • Spécifiez un fournisseur OLE DB avec la propriété Provider.

  • Établissez et arrêtez ultérieurement la connexion physique à la source de données avec les méthodes Open et Close.

  • Exécutez une commande sur la connexion avec la méthode Execute et configurez l’exécution avec la propriété CommandTimeout.

    Note

    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 Connection. Toutefois, un objet Command est requis lorsque vous souhaitez conserver le texte de la commande et le réexécérer, 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, CommitTranset méthodes RollbackTrans et 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 objets Connection indépendamment de tout autre objet précédemment défini.

Vous pouvez exécuter des commandes nommées ou des procédures stockées comme s’ils étaient des méthodes natives sur un objet Connection, comme indiqué dans la section suivante. Lorsqu’une commande nommée porte le même nom que celui d’une procédure stockée, appelez l'« appel de méthode native » sur un objet Connection exécutez toujours la commande nommée au lieu de la procédure stockée.

Note

N’utilisez pas cette fonctionnalité (appel d’une commande nommée ou d’une 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, attribuez un nom à la commande à l’aide de la propriété CommandName. Définissez la propriété ActiveConnection de l’objet command sur la connexion. Émettez ensuite une instruction où le nom de la commande est utilisé comme s’il s’agissait d’une méthode sur l’objet Connection, suivi de paramètres et d’un objet Recordset si des lignes sont retournées. Définissez les propriétés Recordset pour personnaliser le jeu d’enregistrements résultant. 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 où le nom de la procédure stockée est utilisé comme s’il s’agissait d’une méthode sur l’objet Connection, suivi de tous les paramètres. ADO fera une « meilleure estimation » 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 l’écriture de scripts.

Cette section contient la rubrique suivante.

Voir aussi

objet de commande (ADO)
Errors Collection (ADO)
Properties, collection (ADO)
objet Recordset (ADO)
Annexe A : Fournisseurs