共用方式為


ConnectionString 屬性 (ADO)

表示用來建立資料來源連接的資訊。

設定和傳回值

設定或傳回 String 值。

備註

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

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

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

設定 ConnectionString 屬性並開啟 Connection 物件之後,提供者可以藉由將 ADO 定義的引數名稱對應至其特定提供者的對等項目,來改變屬性的內容。

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

因為 File Name 引數會導致 ADO 載入相關聯的提供者,所以您無法同時傳遞 ProviderFile Name 引數。

連接關閉時,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.Connection:未指定提供者,且沒有指定的預設提供者」
Windows 2000 (64 位元)

Windows XP (64 位元)

Windows 2003 Server (64 位元)

Windows Vista (64 位元)

套用至

Connection 物件 (ADO)

另請參閱

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