ConnectionString 属性 (ADO)

指出用來建立數據源連接的資訊。

設定和傳回值

會設定或傳回 String 值。

言論

使用 ConnectionString 屬性來指定數據源,方法是傳遞包含一系列 自變數的詳細連接字串,= 以分號分隔的值 語句。

ADO 支援 ConnectionString 屬性的五個自變數;任何其他自變數會直接傳遞至提供者,而不需要 ADO 處理。 ADO 支援的自變數如下所示。

論點 描述
Provider= 指定要用於連接之提供者的名稱。
檔名= 指定提供者特定檔案的名稱(例如,保存的數據源物件),其中包含預設連接資訊。
遠端提供者= 指定開啟客戶端連線時要使用的提供者名稱。 (僅限遠端資料服務。)
遠端伺服器= 指定開啟客戶端連線時要使用的伺服器路徑名稱。 (僅限遠端資料服務。)
URL= 將連接字串指定為識別資源的絕對 URL,例如檔案或目錄。

設定 ConnectionString 屬性並開啟 Connection 物件之後,提供者可能會藉由將 ADO 定義的自變數名稱對應至特定提供者的對等專案來改變屬性的內容。

ConnectionString 屬性會自動繼承 Open 方法之 ConnectionString 自變數所使用的值,因此您可以在 open 方法呼叫 期間覆寫目前 ConnectionString 属性。

因為 檔名 自變數會導致 ADO 載入相關聯的提供者,所以您無法同時傳遞 提供者 和 檔名 自變數。

ConnectionString 屬性在連接關閉且開啟時為只讀時為可擦寫的。

會忽略 ConnectionString 屬性中的自變數重複專案。 使用任何自變數的最後一個實例。

注意

遠端數據服務使用 在用戶端 Connection 物件上使用時,ConnectionString 屬性只能包含 遠端提供者 和 遠端伺服器 參數。

下表列出每個 Windows 作業系統的預設 ADO 提供者:

預設 ADO 提供者 Windows 作業系統
MSDASQL

(若要改善原始程式碼的可讀性,請在連接字串中明確指定提供者名稱。
Windows 2000 (32 位)

Windows XP (32 位)

Windows 2003 Server (32 位)

Windows Vista (32 位)

Windows Vista Service Pack 1 或更新版本 (32 位和 64 位)

Windows Vista 之後的 Windows 版本 (32 位和 64 位)
沒有預設值。

當 ADO 應用程式在下列作業系統上執行,且未明確指定提供者時,ADO 會傳回下列錯誤:「ADODB。線上:未指定提供者,而且沒有指定的預設提供者」
Windows 2000 (64 位)

Windows XP (64 位)

Windows 2003 Server (64 位)

Windows Vista (64 位)

適用於

Connection 物件 (ADO)

另請參閱

ConnectionString、ConnectionTimeout 和 State 屬性範例 (VB)
ConnectionString、ConnectionTimeout 和 State 屬性範例 (VC++)
附錄 A:提供者