ConnectionString 属性 (ADO)

指示用于建立到数据源的连接的信息。

设置和返回值

设置或返回 String 值。

备注

使用 ConnectionString 属性通过传递包含一系列以分号分隔的“参数 = 值”语句的详细连接字符串来指定数据源。

ADO 支持 ConnectionString 属性的五个参数;任何其他参数直接传递给提供程序,而无需 ADO 进行任何处理。 ADO 支持的参数如下。

参数 说明
Provider= 指定要用于连接的提供程序的名称。
File Name= 指定包含预设连接信息的提供程序特定文件(例如持久数据源对象)的名称。
Remote Provider= 指定打开客户端连接时要使用的提供程序的名称。 (仅限远程数据服务。)
Remote Server= 指定打开客户端连接时要使用的服务器的路径名称。 (仅限远程数据服务。)
URL= 将连接字符串指定为标识资源(如文件或目录)的绝对 URL。

设置 ConnectionString 属性并打开 Connection 对象后,提供程序可能会更改属性的内容,例如,通过将 ADO 定义的参数名称映射到特定提供程序的等效参数名称。

ConnectionString 属性自动继承用于 Open 方法的 ConnectionString 参数的值,因此你可以在 Open 方法调用期间覆盖当前的 ConnectionString 属性。

因为“文件名”参数导致 ADO 加载关联的提供程序,所以你不能同时传递“提供程序”和“文件名”参数。

连接关闭时,ConnectionString 属性是可读/写的,当连接处于打开状态时为只读。

ConnectionString 属性中的重复参数将被忽略。 将使用任何参数的最后一个实例。

注意

远程数据服务使用在客户端 Connection 对象上使用时,ConnectionString 属性只能包括 Remote Provider 和 Remote Server 参数。

下表列出了每个 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 位)

应用于

连接对象 (ADO)

另请参阅

ConnectionString、ConnectionTimeout 和 State 属性示例 (VB)
ConnectionString、ConnectionTimeout 和 State 属性示例 (VC++)
附录 A:提供程序