连接字符串包含作为参数从数据提供程序传递到数据源的初始化信息。 数据访问接口接收连接字符串作为xref:System.Data.Common.DbConnection.ConnectionString?displayProperty=nameWithType属性的值。 提供程序分析连接字符串, 并确保语法正确, 并且支持关键字。 然后, xref:System.Data.Common.DbConnection.Open?displayProperty=nameWithType方法将已分析的连接参数传递到数据源。 数据源执行进一步的验证, 并建立连接。
连接字符串语法
连接字符串是以分号分隔的键/值参数对列表:
keyword1=value; keyword2=value;
关键字不区分大小写。 但是, 值可能区分大小写, 具体取决于数据源。 关键字和值可以包含空格字符。 关键字和无引号值中会忽略前导空格和尾随空格。
如果值包含分号、 Unicode 控制字符或前导或尾随空格, 则必须用单引号或双引号将其引起来。 例如:
Keyword=" whitespace ";
Keyword='special;character';
封闭字符不能出现在它所包含的值中。 因此, 包含单引号的值只能用双引号引起来, 反之亦然:
Keyword='double"quotation;mark';
Keyword="single'quotation;mark";
还可以通过将其中两个字符一起使用来转义封闭字符:
Keyword="double""quotation";
Keyword='single''quotation';
引号本身以及等号不需要进行转义, 因此以下连接字符串有效:
Keyword=no "escaping" 'required';
Keyword=a=b=c
由于每个值都是在下一个分号或字符串末尾之前读取的, 因此后一示例中a=b=c的值为, 而最后的分号是可选的。
所有连接字符串共享上述相同的基本语法。 但所识别的关键字集取决于提供程序, 但在以前的 Api (例如ODBC) 中已经演变。 用于SQL Server (SqlClient) 的 .NET Framework数据提供程序支持来自较低版本 api 的多个关键字, 但通常更灵活, 并接受多个常用连接字符串关键字的同义词。
键入错误会导致错误。 例如, Integrated Security=true是有效的, 但IntegratedSecurity=true会导致错误。
在运行时从未经验证用户输入手动构造的连接字符串容易受到字符串注入式攻击, 并危害数据源的安全性。 为了解决这些问题, ADO.NET 2.0 引入了每个 .NET Framework数据提供程序的连接字符串生成器。 这些连接字符串生成器将参数作为强类型属性公开, 并在将连接字符串发送到数据源之前验证连接字符串。
本节内容
连接字符串生成器
演示如何使用 ConnectionStringBuilder 类在运行时构造有效的连接字符串。
连接字符串和配置文件
演示如何在配置文件中存储和检索连接字符串。
连接字符串语法
描述如何为 SqlClient、OracleClient、OleDb 和 Odbc 配置提供程序专用的连接字符串。
保护连接信息
演示保护用于连接到数据源的信息的各项技术。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
