ActiveConnection 屬性 (ADO)

發行項
05/04/2023

表示指定 Command、Recordset 或 Record 物件目前所屬的 Connection 物件。

設定和傳回值

如果連線關閉，設定或傳回包含連線定義的 String 值；如果連線開啟，設定包含目前 Connection 物件的 Variant。預設為 Null 物件參考。請參閱 ConnectionString 屬性。

備註

使用 ActiveConnection 屬性可決定指定 Command 物件執行或指定 Recordset 開啟的 Connection 物件。

Command

針對 Command 物件，ActiveConnection 屬性為讀取/寫入。

如果您在將此屬性設定為開啟的 Connection 物件或有效的連接字串之前，嘗試在 Command 物件上呼叫 Execute 方法，則會發生錯誤。

如果將 Connection 物件指派給 ActiveConnection 屬性，則必須開啟物件。指派關閉的 Connection 物件時會造成錯誤。

注意

Microsoft Visual Basic 將 ActiveConnection 屬性設定為 Nothing 時，會將 Command 物件與目前的 Connection 取消關聯，導致提供者釋放資料來源上任何相關資源。您接著可將 Command 物件與相同或其他 Connection 物件建立關聯。某些提供者可讓您將屬性設定從一個 Connection 變更為其他物件，而無須先將屬性設定為 Nothing。

當 Command 物件的 Parameters 集合包含提供者所提供的參數時，如果您將 ActiveConnection 屬性設定為 Nothing 或其他 Connection 物件，則會清除集合。如果您手動建立 Parameter 物件並用來填入 Command 物件的 Parameters 集合，則將 ActiveConnection 屬性設定為 Nothing 或其他 Connection 物件時，Parameters 集合會保持不變。

關閉與 Command 物件相關聯的 Connection 物件時，會將 ActiveConnection 設定為 Nothing。將此屬性設定為關閉的 Connection 物件時，會產生錯誤。

資料錄集

針對開啟的 Recordset 物件或 Recordset 物件，若其 Source 屬性設定為有效的 Command 物件，ActiveConnection 屬性為唯讀。若否，則為讀取/寫入。

您可以將此屬性設定為有效的 Connection 物件或有效的連接字串。在此情況下，提供者會使用此定義建立新的 Connection 物件並開啟連線。此外，提供者可能會將此屬性設定為新的 Connection 物件，可讓您存取 Connection 物件以取得延伸錯誤資訊或執行其他命令。

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

如果將 Recordset 物件的 Source 屬性設定為有效的 Command 物件變數，Recordset 的 ActiveConnection 屬性會繼承 Command 物件的 ActiveConnection 屬性設定。

注意

遠端資料服務使用 在用戶端 Recordset 物件上使用時，此屬性僅可設定為連接字串或 (在 Microsoft Visual Basic 或 Visual Basic、Scripting Edition) Nothing。

Record

當 Record 物件關閉時，此屬性為讀取/寫入，而且可能包含開啟 Connection 物件的連接字串或參考。當 Record 物件開啟時，此屬性為唯讀，而且包含開啟 Connection 物件的參考。

當 Record 物件透過 URL 開啟時，會隱含建立 Connection 物件。透過將 Connection 物件指派給此屬性或使用 Connection 物件作為 Open 方法呼叫中的參數，從而開啟具有現有開啟 Connection 物件的 Record。如果 Record 從現有 Record 或 Recordset 開啟，則會自動與該 Record 或 Recordset 物件的 Connection 物件建立關聯。