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"

套用至

Catalog 物件 (ADO MD)

Cellset 物件 (ADO MD)

另請參閱

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