Partager via


ActiveConnection, propriété (ADO MD)

Indique à quel objet ADO Connection l’objet cellset ou catalogue actuel appartient.

Paramètres et valeurs de retour

Définit ou renvoie un variant qui contient une chaîne définissant une connexion ou un objet Connection . La valeur par défaut est vide.

Remarques

Vous pouvez définir cette propriété sur un objet de connexion ADO valide ou sur une chaîne de connexion valide. Lorsque cette propriété est définie sur une chaîne de connexion, le fournisseur crée un objet Connection à l’aide de 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, y compris 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 catalogue 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 du catalogue.

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

Remarque

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 réellement la propriété ActiveConnection égale à la propriété par défaut de l’objet Connection , ConnectionString. Le code fonctionnera ; Toutefois, vous allez créer une connexion supplémentaire à la source de données, ce qui peut avoir des implications négatives 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 à partir 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 complet du fichier . 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é Nom de serveur :

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

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

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

S’applique à

Voir aussi

Cellset - Exemple (VB)
Objet de Connexion (ADO)
Open, méthode (ADO MD)