ActiveConnection, propriété (ADO MD)

Indique l’objet ADO Connection auquel appartiennent actuellement l’ensemble de cellules ou le catalogue actifs.

Paramètres et valeurs de retour

Définit ou retourne un objet Variant contenant une chaîne définissant une connexion ou un objet Connection. Vide par défaut.

Notes

Vous pouvez définir cette propriété sur un objet ADO Connection ou sur une chaîne de connexion valides. Quand cette propriété est définie sur une chaîne de connexion, le fournisseur crée un nouvel objet Connection en utilisant cette définition, et ouvre la connexion.

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

La définition de la propriété ActiveConnection d’un objet Catalog sur Nothing libère les données associées, dont les données de la collection CubeDefs et les objets Dimension, Hierarchy, Level et Member associés. La fermeture d’un objet Connection utilisé pour ouvrir un objet Catalog a le même effet que la définition de la propriété ActiveConnection sur Nothing.

La modification de la base de données par défaut de la connexion référencée par la propriété ActiveConnection d’un objet Catalog invalide le contenu de celui-ci.

Une erreur se produit si vous tentez de modifier la propriété ActiveConnection pour un objet Cellset ouvert.

Notes

Dans Visual Basic, n’oubliez pas d’utiliser le mot clé Set lors de la définition de la propriété ActiveConnection sur un objet Connection. Si vous omettez le mot clé Set, vous définissez en fait la propriété ActiveConnection égale à la propriété par défaut de l’objet Connection, ConnectionString. Le code fonctionnera mais vous allez créer une connexion supplémentaire à la source de données, ce qui peut avoir une incidence négative sur les performances.

Lorsque vous utilisez le fournisseur de données MSOLAP, définissez la source de données dans une chaîne de connexion sur un nom de serveur, et définissez le catalogue initial sur le nom d’un catalogue de la source de données. Pour vous connecter à un fichier de cube déconnecté d’un serveur, définissez l’emplacement sur le chemin d’accès complet du fichier .CUB. Dans les deux cas, définissez le fournisseur sur le nom du fournisseur. Par exemple, la chaîne suivante utilise le fournisseur MSOLAP pour se connecter à un catalogue nommé Bobs Video Store sur un serveur nommé Servername :

"Data Source=Servername;Initial Catalog=Bobs Video Store;Provider=msolap"  

La chaîne suivante se connecte à un fichier de cube local dans l’emplacement C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub :

"Location=C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub;Provider=msolap"  

S'applique à

Catalog, objet (ADO MD)

Cellset, objet (ADO MD)

Voir aussi

Exemple avec Cellset (VB)
Connection, objet (ADO)
Open, méthode (ADO MD)