ActiveConnection, propriété (ADO)

S’applique à : Access 2013, Office 2013

Indique l'objet Connection auquel l'objet Command, Recordset ou Record spécifié appartient actuellement.

Paramètres et valeurs de retour

Définit ou renvoie une valeur de type String contenant la définition d'une connexion si la connexion est fermée, ou une valeur Variant contenant l'objet Connection actif si la connexion est ouverte. La valeur par défaut est une référence d'objet Null. Reportez-vous à la propriété ConnectionString.

Remarques

Utilisez la propriété ActiveConnection pour déterminer l'objet Connection sur lequel l'objet Command est exécuté ou sur lequel l'objet Recordset spécifié est ouvert.

Command

Pour les objets Command, la propriété ActiveConnection est en lecture/écriture.

Si vous tentez d'appeler la méthode Execute sur un objet Command avant d'affecter à cette propriété un objet Connection ouvert ou une chaîne de connexion valide, une erreur se produit.

Microsoft Visual Basic : Si vous affectez la valeur Nothing à la propriété ActiveConnection, l’objet Command est dissocié de la connexion actuelle et le fournisseur libère toutes les ressources associées sur la source de données. Vous pouvez alors associer l’objet Command au même objet Connection ou à un autre. Certains fournisseurs permettent de remplacer l’objet Connection défini dans la propriété par un autre, sans devoir préalablement affecter à la propriété la valeur Nothing.

Si la collection Parameters de l’objet Command contient les paramètres fournis par le fournisseur, le contenu de la collection est effacé si vous attribuez à la propriété ActiveConnection la valeur Nothing ou un autre objet Connection. Si vous créez manuellement des objets Parameter et que vous les utilisez pour remplir la collection Parameters de l’objet Command, l’affectation de la valeur Nothing ou d’un autre objet Connection à la propriété ActiveConnection ne modifie pas la collection Parameters.

La fermeture de l'objet Connection auquel est associé un objet Command affecte à la propriété ActiveConnection la valeur Nothing. L'attribution d'un objet Connection fermé à cette propriété génère une erreur.

Recordset

Pour les objets Recordset ouverts ou pour les objets Recordset dont la propriété Source a pour valeur un objet Command valide, la propriété ActiveConnection est en lecture seule. Autrement, elle est en lecture/écriture.

Vous pouvez affecter à cette propriété un objet Connection valide ou une chaîne de connexion valide. Dans ce cas, le fournisseur crée un objet Connection à l'aide de cette définition et ouvre la connexion. De plus, le fournisseur peut définir cette propriété sur le nouvel objet Connection pour vous permettre d'accéder à l'objet Connection et obtenir des informations complémentaires relatives à l'objet ou exécuter d'autres commandes.

Si vous utilisez l’argument ActiveConnection de la méthode Open pour ouvrir un objet Recordset, la propriété ActiveConnection hérite de la valeur de l’argument.

Si vous affectez à la propriété Source de l'objet Recordset une variable d'objet Command valide, la propriété ActiveConnection de l'objet Recordset hérite du paramètre de la propriété ActiveConnection de l'objet Command.

Utilisation du service de données distant : lorsqu’elle est utilisée sur un objet Recordset côté client, cette propriété peut être définie uniquement sur un chaîne de connexion ou (dans Microsoft Visual Basic ou Visual Basic, Scripting Edition) sur Nothing.

Enregistrement

Cette propriété est en lecture/écriture lorsque l'objet Record est fermé et peut contenir une chaîne de connexion ou une référence à un objet Connection ouvert. Cette propriété est en lecture seule lorsque l'objet Record est ouvert et qu'il contient une référence à un objet Connection ouvert.

Un objet Connection est créé implicitement lorsque l'objet Record est ouvert à partir d'une URL. Ouvrez l'objet Record à l'aide d'un objet Connection existant ouvert en affectant à cette propriété l'objet Connection ou en utilisant l'objet Connection comme paramètre dans l'appel de la méthode Open. Si l’objet Record est ouvert à partir d’un objet Record ou Recordset existant, il est automatiquement associé à l’objet Connection de cet objet Record ou Recordset.