ConnectionString属性「建议收藏」

大家好，又见面了，我是你们的朋友全栈君。

ConnectionString 类似于 OLE DB 连接字符串，但并不相同。与 OLE DB 或 ADO 不同，如果“Persist Security Info”值设置为 false（默认值），则返回的连接字符串与用户设置的 ConnectionString 相同但去除了安全信息。除非将“Persist Security Info”设置为 true，否则，SQL Server .NET Framework 数据提供程序将不会保持，也不会返回连接字符串中的密码。

可以使用 ConnectionString 属性连接到数据库。下面的示例阐释了一个典型的连接字符串。

"Persist Security Info=False;Integrated Security=SSPI;Initial Catalog=Northwind;server=(local)"

使用新的 SqlConnectionStringBuilder 在运行时构造有效的连接字符串。有关更多信息，请参见 Building Connection Strings。

只有在连接关闭时才能设置 ConnectionString 属性。许多连接字符串值都具有相应的只读属性。当设置连接字符串时，将更新这些属性（除非检测到错误）。在此情况下，不会更新任何属性。SqlConnection 属性只返回那些包含在 ConnectionString 中的设置。

若要连接到本地计算机，请将服务器指定为“(本地)”。（必须始终指定一个服务器。）

重置已关闭连接上的 ConnectionString 会重置包括密码在内的所有连接字符串值（和相关属性）。例如，如果设置一个连接字符串，其中包含“Database= AdventureWorks”，然后再将该连接字符串重置为“Data Source=myserver;Integrated Security=SSPI”，则 Database 属性将不再设置为“AdventureWorks”。

在设置后会立即分析连接字符串。如果在分析时发现语法中有错误，则产生运行库异常，如 ArgumentException。只有当试图打开连接时，才会发现其他错误。

连接字符串的基本格式包括一系列由分号分隔的关键字/值对。等号 (= ) 连接各个关键字及其值。若要包括含有分号、单引号字符或双引号字符的值，则该值必须用双引号括起来。如果该值同时包含分号和双引号字符，则该值可以用单引号括起来。如果该值以双引号字符开始，则也可以使用单引号。相反，如果该值以单引号开始，也可以使用双引号。如果该值同时包含单引号和双引号字符，则用于将该值括起来的引号字符每次出现时，都必须成对出现。

若要在字符串值中包括前导或尾随空格，则该值必须用单引号或双引号括起来。即使将整数、布尔值或枚举值用引号括起来，其周围的任何前导或尾随空格也将被忽略。然而，保留字符串关键字或值内的空格。使用 .NET Framework 1.1 版或更高版本时，在连接字符串中可以使用单引号或双引号，而不用使用分隔符（例如，Data Source= my’Server 或 Data Source= my”Server），但引号字符不可以为值的第一个或最后一个字符。

若要在关键字或值中包括等号 (=)，则它之前必须还有另一个等号。例如，在假设的连接字符串中，

"key==word=value"

关键字是“key=word”并且值是“value”。

如果关键字/值对中的一个特定关键字多次出现在连接字符串中，则将所列出的最后一个用于值集。

关键字不区分大小写。

下表列出了 ConnectionString 中的关键字值的有效名称。

关键字

默认值

说明

Application Name

N/A

应用程序的名称，或者“.Net SqlClient Data Provider”（如果不提供应用程序名称）。

Asynch

‘false’

如果设置为 true，则启用异步操作支持。可识别的值为 true、false、yes 和 no。

AttachDBFilename

– 或 –

extended properties

– 或 –

Initial File Name

N/A

主数据库文件的名称，包括可连接数据库的完整路径名。该路经可以是绝对路径，也可以是相对路径，这取决于是否使用 DataDirectory 替换字符串。如果使用 DataDirectory，则对应的数据库文件必须存在于替换字符串指向的目录的子目录中。

远程服务器、HTTP 及 UNC 路径名不受支持。

必须按照如下方式使用关键字“database”（或其别名之一）指定数据库名称：

"AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase"

Connect Timeout

– 或 –

Connection Timeout

在终止尝试并产生错误之前，等待与服务器的连接的时间长度（以秒为单位）。

Context Connection

‘false’

如果应对 SQL Server 进行进程内连接，则为 true。

Current Language

N/A

SQL Server 语言记录名称。

Data Source

– 或 –

Server

– 或 –

Address

– 或 –

Addr

– 或 –

Network Address

N/A

要连接的 SQL Server 实例的名称或网络地址。可以在服务器名称之后指定端口号：

server=tcp:servername, portnumber

指定本地实例时，始终使用 (local)。若要强制使用某个协议，请添加下列前缀之一：

np:(local), tcp:(local), lpc:(local)

Encrypt

‘false’

当该值为 true 时，如果服务器端安装了证书，则 SQL Server 将对所有在客户端和服务器之间传送的数据使用 SSL 加密。可识别的值为 true、false、yes 和 no。

Enlist

‘false’

true 表明 SQL Server 连接池程序在创建线程的当前事务上下文中自动登记连接。

Failover Partner

N/A

在其中配置数据库镜像的故障转移合作伙伴服务器的名称。

.NET Framework 1.0 或 1.1 版不支持 Failover Partner 关键字。

Initial Catalog

– 或 –

Database

N/A

数据库的名称。

Integrated Security

– 或 –

Trusted_Connection

‘false’

当为 false 时，将在连接中指定用户 ID 和密码。当为 true 时，将使用当前的 Windows 帐户凭据进行身份验证。

可识别的值为 true、false、yes、no 以及与 true 等效的 sspi（强烈推荐）。

MultipleActiveResultSets

‘true’

如果为 true，则应用程序可以维护多活动结果集 (MARS)。如果为 false，则应用程序必须在执行该连接上的任何其他批处理之前处理或取消一个批处理中的多个结果集。

可识别的值为 true 和 false。

.NET Framework 1.0 或 1.1 版不支持该关键字。

Network Library

– 或 –

Net

‘dbmssocn’

用于建立与 SQL Server 实例的连接的网络库。支持的值包括 dbnmpntw（命名管道）、dbmsrpcn（多协议）、dbmsadsn (Apple Talk)、dbmsgnet (VIA)、dbmslpcn（共享内存）及 dbmsspxn (IPX/SPX) 和 dbmssocn (TCP/IP)。

相应的网络 DLL 必须安装在要连接的系统上。如果不指定网络而使用一个本地服务器（比如“.”或“(local)”），则使用共享内存。

Packet Size

8192

用来与 SQL Server 的实例进行通信的网络数据包的大小，以字节为单位。

Password

– 或 –

Pwd

N/A

SQL Server 帐户登录的密码。建议不要使用。为保持高安全级别，我们强烈建议您使用 Integrated Security 或 Trusted_Connection 关键字。

Persist Security Info

‘false’

当该值设置为 false 或 no（强烈推荐）时，如果连接是打开的或者一直处于打开状态，那么安全敏感信息（如密码）将不会作为连接的一部分返回。重置连接字符串将重置包括密码在内的所有连接字符串值。可识别的值为 true、false、yes 和 no。

Replication

‘false’

如果使用连接来支持复制，则为 true。

TrustServerCertificate

‘false’

如果设置为 true，则使用 SSL 对通道进行加密，但不通过证书链对可信度进行验证。如果将 TrustServerCertificate 设置为 true 并将 Encrypt 设置为 false，则不对通道进行加密。可识别的值为 true、false、yes 和 no。有关更多信息，请参见 SQL Server 2005 Books Online（《SQL Server 2005 联机丛书》）中的“Encryption Hierarchy”（加密层次结构）和“Using Encryption Without Validation”（使用不验证的加密）。

Type System Version

N/A

指示应用程序期望的类型系统的字符串值。可能的值有：

Type System Version=SQL Server 2000;

Type System Version=SQL Server 2005;

Type System Version=Latest;

如果设置为 SQL Server 2000，将使用 SQL Server 2000 类型系统。与 SQL Server 2005 实例连接时，执行下列转换：

XML 到 NTEXT

UDT 到 VARBINARY

VARCHAR(MAX)、NVARCHAR(MAX) 和 VARBINARY(MAX) 分别到 TEXT、NEXT 和 IMAGE。

如果设置为 SQL Server 2005，将使用 SQL Server 2005 类型系统。对 ADO.NET 的当前版本不进行任何转换。

如果设置为 Latest，将使用此客户端-服务器对无法处理的最新版本。这个最新版本将随着客户端和服务器组件的升级自动更新。

User ID

N/A

SQL Server 登录帐户。建议不要使用。为保持高安全级别，我们强烈建议您使用 Integrated Security 或 Trusted_Connection 关键字。

User Instance

‘false’

一个值，用于指示是否将连接从默认的 SQL Server 速成版实例重定向到调用方帐户下运行的运行时启动的实例。

Workstation ID

本地计算机名称

连接到 SQL Server 的工作站的名称。

下表列出了 ConnectionString 内连接池值的有效名称。有关更多信息，请参见使用连接池。

名称	默认值	说明
Connection Lifetime	0	当连接被返回到池时，将其创建时间与当前时间作比较，如果时间长度（以秒为单位）超出了由 Connection Lifetime 指定的值，该连接就会被销毁。这在聚集配置中很有用（用于强制执行运行中的服务器和刚置于联机状态的服务器之间的负载平衡）。零 (0) 值将使池连接具有最大的连接超时。
Connection Reset	‘true’	确定从池中提取数据库连接时是否重置数据库连接。对于 SQL Server 7.0 版，设置为 false 可避免获取连接时再有一次额外的服务器往返行程，但须注意此时并未重置连接状态（如数据库上下文）。只要不将 Connection Reset 设置为 false，连接池程序就不会受到 ChangeDatabase 方法的影响。连接在退出相应的连接池以后将被重置，并且服务器将移回登录时数据库。不会创建新的连接，也不会重新进行身份验证。如果将 Connection Reset 设置为 false，则池中可能会产生不同数据库的连接。
Enlist	‘true’	当该值为 true 时，池程序在创建线程的当前事务上下文中自动登记连接。可识别的值为 true、false、yes 和 no。
Load Balance Timeout	0	连接被销毁前在连接池中生存的最短时间（以秒为单位）。
Max Pool Size	100	池中允许的最大连接数。
Min Pool Size	0	池中允许的最小连接数。
Pooling	‘true’	当该值为 true 时，系统将从适当的池中提取 SQLConnection 对象，或在需要时创建该对象并将其添加到适当的池中。可识别的值为 true、false、yes 和 no。