ActiveConnection 屬性 (ADO)
指出指定的 Command、Recordset或目前 Record 物件 Connection 物件。
設定和傳回值
會設定或傳回 String 值,這個值包含連接關閉時連接的定義,或者如果連接已開啟,則為包含目前 Connection 物件的 Variant。 預設值為 Null 物件參考。 請參閱 connectionString 屬性。
言論
使用 ActiveConnection 屬性來判斷指定的 Command 物件將執行 Connection 物件,或開啟指定的 Recordset。
命令
對於 Command 物件,ActiveConnection 屬性是可擦寫的。
如果您在命令 Command 對象上嘗試呼叫 Execute 方法,然後再將此屬性設定為開啟 Connection 物件或有效的連接字元串,就會發生錯誤。
如果將 Connection 物件指派給 activeConnection 屬性,則必須開啟物件。 指派關閉的 Connection 物件會造成錯誤。
注意
Microsoft Visual Basic 將 ActiveConnection 属性 設定為 Nothing 會解除與目前 Connection 的 Command 對象關聯,並讓提供者在數據源上釋放任何相關聯的資源。 然後,您可以將 Command 物件與相同或另一個 Connection 對象產生關聯。 某些提供者可讓您將屬性設定從某個 Connection 變更為另一個,而不需要先將 屬性設定為 Nothing。
如果 Command 物件的 Parameters 集合包含提供者所提供的參數,則如果您將 ActiveConnection 屬性 設定為 Nothing 或其他 Connection 物件,則會清除集合。 如果您手動建立 Parameter 物件,並使用它們來填入 Command 物件的 Parameters 集合,請將 activeConnection 属性 設定為 Nothing 或其他 Connection 物件,讓 Parameters 集合保持不變。
關閉 Connection 物件,Command 物件 相關聯,會將 ActiveConnection 屬性設定為 Nothing。 將此屬性設定為已關閉 Connection 物件會產生錯誤。
Recordset
對於開啟 Recordset 物件,或 Recordset 物件的 Source 屬性設定為 有效的 command 物件,則 activeConnection 屬性 為只讀。 否則,它是可擦寫的。
您可以將此屬性設定為有效的 Connection 物件或有效的連接字串。 在此情況下,提供者會使用此定義建立新的 Connection 物件,並開啟連接。 此外,提供者可能會將這個屬性設定為新的 Connection 物件,讓您能夠存取擴充錯誤資訊或執行其他命令的 Connection 物件。
如果您使用 Open 方法的 ActiveConnection 自變數來開啟 Recordset 物件,則 activeConnection 屬性會繼承自變數的值。
如果您將 recordset Recordset 物件的 Source 属性設定為有效的 Command 物件變數,則 RecordsetActiveConnection 属性會繼承 Command 物件的 ActiveConnection 属性的設定。
注意
遠端數據服務使用方式 在用戶端 Recordset 物件上使用時,此屬性只能設定為連接字串或(Microsoft 在 Visual Basic 或 Visual Basic 中為 Scripting Edition 中),Nothing。
記錄
當 Record 物件關閉時,這個屬性是可擦寫的,而且可能包含開啟 Connection 對象的連接字串或參考。 當 Record 對象開啟時,這個屬性是唯讀的,而且包含開啟 Connection 對象的參考。
從 URL 開啟 Record 物件時,會隱含建立 Connection 物件。 使用現有的、開啟 Connection 物件,將 connection 物件指派給這個屬性,或使用 Connection 對象作為 Open 方法呼叫中的參數,以開啟 Record。 如果從現有的 Record 或 Recordset開啟 Record,則它會自動與該 Record 或 Recordset 物件的 Connection 物件相關聯。
注意
使用 HTTP 配置的 URL 會自動叫用 Microsoft OLE DB Provider for Internet Publishing。 如需詳細資訊,請參閱 絕對和相對URL。
適用於
另請參閱
ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性範例 (VB)
ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性範例 (VC++)
ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性範例 (JScript)
Connection 物件 (ADO)
ConnectionString 屬性 (ADO)