Share via

ActiveConnection-Eigenschaft (ADO MD)

  • Artikel

Gibt an, zu welchem ADO-Connection-Objekt das aktuelle Cellset oder der Katalog derzeit gehört.

Einstellungen und Rückgabewerte

Legt einen Variant-Wert mit einer Zeichenfolge, die eine Verbindung oder ein Connection-Objekt definiert, fest oder gibt ihn zurück. Standardmäßig ist diese Eigenschaft leer.

Bemerkungen

Sie können diese Eigenschaft auf ein gültiges ADO-Connection-Objekt oder auf eine gültige Verbindungszeichenfolge festlegen. Wenn diese Eigenschaft auf eine Verbindungszeichenfolge festgelegt ist, erstellt der Anbieter ein neues Connection-Objekt anhand dieser Definition und öffnet die Verbindung.

Wenn Sie das ActiveConnection-Argument der Open-Methode verwenden, um ein Recordset-Objekt zu öffnen, erbt die ActiveConnection-Eigenschaft den Wert des Arguments.

Wenn Sie die ActiveConnection-Eigenschaft eines Catalog-Objekts auf Nothing festlegen, werden die zugeordneten Daten freigegeben, einschließlich der Daten in der CubeDefs-Sammlung und aller zugehörigen Dimension-, Hierarchy-, Level- und Member-Objekte. Das Schließen eines Connection-Objekts, das zum Öffnen eines Katalogs verwendet wurde, hat den gleichen Effekt wie das Festlegen der ActiveConnection-Eigenschaft auf Nothing.

Durch das Ändern der Standarddatenbank der Verbindung, auf die die ActiveConnection-Eigenschaft eines Catalog-Objekts verweist, wird der Inhalt des Katalogs ungültig.

Ein Fehler tritt auf, wenn Sie versuchen, die ActiveConnection-Eigenschaft für ein geöffnetes Cellset-Objekt zu ändern.

Hinweis

Denken Sie in Visual Basic daran, das Schlüsselwort Set zu verwenden, wenn Sie die ActiveConnection-Eigenschaft auf ein Connection-Objekt festlegen. Wenn Sie das Schlüsselwort Set weglassen, wird die ActiveConnection-Eigenschaft auf den Wert der Standardeigenschaft ConnectionString des Connection-Objekts festgelegt. Der Code funktioniert, Sie erstellen jedoch eine zusätzliche Verbindung mit der Datenquelle, wodurch die Leistung beeinträchtigt werden kann.

Legen Sie beim Verwenden des MSOLAP-Datenanbieters die Datenquelle in einer Verbindungszeichenfolge auf einen Servernamen fest, und legen Sie den Anfangskatalog auf den Namen eines Katalogs aus der Datenquelle fest. Wenn Sie eine Verbindung mit einer Cubedatei herstellen möchten, die von einem Server getrennt ist, legen Sie den Speicherort auf den vollständigen Pfad der CUB-Datei fest. Legen Sie in beiden Fällen den Anbieter auf den Anbieternamen fest. In der folgenden Zeichenfolge wird beispielsweise der MSOLAP-Anbieter verwendet, um eine Verbindung mit einem Katalog namens „Bobs Video Store“ auf einem Server namens Servername herzustellen:

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

Die folgende Zeichenfolge stellt eine Verbindung mit einer lokalen Cubedatei am Speicherort „C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub“ her:

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

Gilt für

Catalog-Objekt (ADO MD)

Cellset-Objekt (ADO MD)

Weitere Informationen

Cellset-Beispiel (VB)
Connection-Objekt (ADO)
Open-Methode (ADO MD)