共用方式為


ActiveConnection 屬性 (ADO MD)

指出目前儲存格集或目錄目前所屬的 ADO Connection 物件。

設定和傳回值

設定或傳回 Variant,其中包含定義連接或 Connection 物件的字串。 預設值為空白。

備註

您可以將此屬性設定為有效的 ADO Connection 物件或有效的連接字串。 當此屬性設定為連接字串時,提供者會使用此定義建立新的 Connection 物件,並開啟連接。

如果您使用 Open 方法的 ActiveConnection 引數來開啟 Cellset 物件,ActiveConnection 屬性會繼承引數的值。

Catalog 物件的 ActiveConnection 屬性設定為 Nothing 會釋放相關聯的資料,包括 CubeDefs 集合中的資料,以及任何相關的 DimensionHierarchyLevelMember 物件。 關閉用來開啟 CatalogConnection 物件,與將 ActiveConnection 屬性設定為 Nothing 的效果相同。

變更 Catalog 物件的 ActiveConnection 屬性所參考連接的預設資料庫,會使 Catalog 的內容失效。

如果您嘗試變更已開啟 Cellset 物件的 ActiveConnection 屬性,就會發生錯誤。

注意

在 Visual Basic 中,請記得在將 ActiveConnection 屬性設定為 Connection 物件時使用 Set 關鍵字。 如果您省略 Set 關鍵字,實際上會設定等於 Connection 物件預設屬性 ConnectionStringActiveConnection 屬性。 程式碼將會運作;不過,您將建立與資料來源的額外連線,這可能會對效能造成負面影響。

使用 MSOLAP 資料提供者時,將連接字串中的資料來源設定為伺服器名稱,並將初始目錄設定為資料來源中的目錄名稱。 若要連線至與伺服器中斷連線的 Cube 檔案,請將位置設定為 CUB 檔案的完整路徑。 不論是哪一種情況,請將提供者設定為提供者名稱。 例如,下列字串會使用 MSOLAP 提供者,連線至伺服器名稱為 Servername的 Bobs 影片存放區目錄:

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

下列字串會連接到位於 C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub 位置的本機 Cube 檔案:

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

套用至

另請參閱

Cellset 範例 (VB)
Connection 物件 (ADO)
Open 方法 (ADO MD)