ActiveConnection 屬性 (ADO MD)
指出目前儲存格集或目錄目前所屬的 ADO Connection 物件。
設定和傳回值
設定或傳回 Variant,其中包含定義連接或 Connection 物件的字串。 預設值為空白。
備註
您可以將此屬性設定為有效的 ADO Connection 物件或有效的連接字串。 當此屬性設定為連接字串時,提供者會使用此定義建立新的 Connection 物件,並開啟連接。
如果您使用 Open 方法的 ActiveConnection 引數來開啟 Cellset 物件,ActiveConnection 屬性會繼承引數的值。
將 Catalog 物件的 ActiveConnection 屬性設定為 Nothing 會釋放相關聯的資料,包括 CubeDefs 集合中的資料,以及任何相關的 Dimension、Hierarchy、Level 和 Member 物件。 關閉用來開啟 Catalog 的 Connection 物件,與將 ActiveConnection 屬性設定為 Nothing 的效果相同。
變更 Catalog 物件的 ActiveConnection 屬性所參考連接的預設資料庫,會使 Catalog 的內容失效。
如果您嘗試變更已開啟 Cellset 物件的 ActiveConnection 屬性,就會發生錯誤。
注意
在 Visual Basic 中,請記得在將 ActiveConnection 屬性設定為 Connection 物件時使用 Set 關鍵字。 如果您省略 Set 關鍵字,實際上會設定等於 Connection 物件預設屬性 ConnectionString 的 ActiveConnection 屬性。 程式碼將會運作;不過,您將建立與資料來源的額外連線,這可能會對效能造成負面影響。
使用 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"