Propriété ActiveConnection (ADO MD)

S’applique à : Access 2013, Office 2013

Indique à quel objet Connection ADO l’ensemble de cellules ou le catalogue actif appartient actuellement.

Paramètres et valeurs de retour

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

Remarques

Vous pouvez affecter à cette propriété un objet Connection ADO valide ou une chaîne de connexion valide. Dans ce dernier cas, le fournisseur crée un nouvel 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éritera de la valeur de l'argument.

Lorsque vous attribuez la valeur Nothing à la propriété ActiveConnection d'un objet Catalog, vous libérez les données associées, ainsi que celles de la collection CubeDefs et de tous les objets Dimension, Hierarchy, Level et Member liés. La fermeture d’un objet Connection utilisé pour ouvrir un objet Catalog revient à attribuer la valeur Nothing à la propriété ActiveConnection.

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 object invalide le contenu de l'objet Catalog.

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

Remarque

In Visual Basic, remember to use the Set keyword when setting the ActiveConnection property to a Connection object. If you omit the Set keyword, you will actually be setting the ActiveConnection property equal to the Connection object's default property, ConnectionString. The code will work; however, you will create an additional connection to the data source, which may have negative performance implications.

Lorsque vous utilisez le fournisseur de données MSOLAP, définissez comme source de données d'une chaîne de connexion un nom de serveur et affectez au catalogue initial le nom d'un catalogue de la source de données. Pour vous connecter à un fichier de cube déconnecté d’un serveur, affectez comme valeur d’emplacement le chemin d’accès complet au fichier .CUB. Dans tous les cas, attribuez au fournisseur le nom du fournisseur. Par exemple, la chaîne suivante se connecte à un catalogue intitulé « Bobs Video Store » sur un serveur dénommé « Servername » avec le fournisseur MSOLAP :

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

La chaîne suivante effectue la connexion à un fichier de cube local situé à l'emplacement C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub :

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