ConnectionString 属性 (ADO)
指示用于建立到数据源的连接的信息。
设置和返回值
设置或返回 String 值。
注解
使用 ConnectionString 属性通过传递包含一系列参数 = 值语句(用分号分隔)的详细连接字符串来指定数据源。
ADO 支持 ConnectionString 属性的五个参数;任何其他参数直接传递给提供程序,而无需 ADO 进行任何处理。 ADO 支持的参数如下。
Argument | 说明 |
---|---|
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 位) |
应用于
另请参阅
ConnectionString、ConnectionTimeout 和 State 属性示例 (VB)
ConnectionString、ConnectionTimeout 和 State 属性示例 (VC++)
附录 A:提供程序