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 位) |
適用於
另請參閱
ConnectionString、ConnectionTimeout 和 State 屬性範例 (VB)
ConnectionString、ConnectionTimeout 和 State 屬性範例 (VC++)
附錄 A:提供者