ActiveConnection, propriété (ADO)

Article
05/30/2023

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

Paramètres et valeurs de retour

Définit ou renvoie une valeur String qui contient une définition pour une connexion si la connexion est fermée, ou un Variant contenant l’objet Connection actuel si la connexion est ouverte. La valeur par défaut est une référence d’objet nulle. Voir la propriété ConnectionString.

Notes

Utilisez la propriété ActiveConnection pour déterminer l’objet Connection sur lequel l’objet Command spécifié s’exécutera ou l’objet Recordset spécifié sera ouvert.

Commande

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

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

Si un objet Connection est affecté à la propriété ActiveConnection, l’objet doit être ouvert. L’attribution d’un objet Connection fermé provoque une erreur.

Notes

Microsoft Visual Basic La définition de la propriété ActiveConnection sur Nothing dissocie l’objet Command de l’objet Connection actuel et entraîne la publication de toutes les ressources associées sur la source de données. Vous pouvez ensuite associer l’objet Command au même objet Connection ou à un autre objet Connection. Certains fournisseurs vous permettent de modifier le paramètre de propriété d’un objet Connection à un autre, sans avoir à définir la propriété sur Nothing.

Si la collection Parameters de l’objet Command contient des paramètres fournis par le fournisseur, la collection est effacée si vous définissez la propriété ActiveConnection sur Nothing ou sur un autre objet Connection. Si vous créez manuellement des objets Parameter et les utilisez pour remplir la collection Parameters de l’objet Command, la définition de la propriété ActiveConnection sur Nothing ou sur un autre objet Connection laisse la collection Parameters intacte.

La fermeture de l’objet Connection avec lequel un objet Command est associé définit la propriété ActiveConnection sur Nothing. La définition de cette propriété sur un objet Connection fermé génère une erreur.

Ensemble d'enregistrements

Pour les objets Recordset ouverts ou pour les objets Recordset dont la propriété Source est définie sur un objet Command valide, la propriété ActiveConnection est en lecture seule. Sinon, elle est en lecture-écriture.

Vous pouvez définir cette propriété sur un objet Connection valide ou sur 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. En outre, le fournisseur peut définir cette propriété sur le nouvel objet Connection pour vous permettre d’accéder à l’objet Connection pour obtenir des informations d’erreur étendues 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 définissez la propriété Source de l’objet Recordset sur 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.

Notes

Utilisation de Remote Data Service Lorsqu’elle est utilisée sur un objet Recordset côté client, cette propriété peut être définie uniquement sur une chaîne de connexion ou (en 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 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 avec un objet Connection existant, ouvrez l’objet Connection en affectant l’objet Connection à cette propriété ou en utilisant l’objet Connection comme paramètre dans l’appel de méthode Open. Si l’objet Record est ouvert à partir d’un objet Record ou Recordset existant, il est automatiquement associé à cet objet Record ou à l’objet Connection du Recordset.