ConnectionSettings 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
连接设置和创建
public class ConnectionSettings
type ConnectionSettings = class
Public Class ConnectionSettings
- 继承
-
ConnectionSettings
- 派生
字段
| 名称 | 说明 |
|---|---|
| NoConnectionTimeout |
无限等待 |
属性
| 名称 | 说明 |
|---|---|
| AcceptsLogin |
如果 LoginSecure 和 Authentication 的当前值使用 Login 属性,则返回 true |
| AccessToken |
连接设置和创建 |
| ApplicationIntent |
连接有效值的应用程序意向为 ReadWrite 和 ReadOnly |
| ApplicationName |
应用程序的名称。 如果未提供任何应用程序名称,则为“SQL 管理”。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException |
| Authentication |
连接的身份验证类型 |
| ConnectAsUser |
如果设置为 true,将使用指定用户的凭据建立连接。 这将假定模拟,但 LoginSecure 标志和登录名和密码字段不会受到影响。 此设置仅在Windows可用。 |
| ConnectAsUserName |
指定创建模拟连接时使用的Windows用户。 用户必须具有交互式登录权限。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException |
| ConnectAsUserPassword |
指定创建模拟连接时使用的Windows用户的密码。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException |
| ConnectionString |
该属性将返回指定的用户连接字符串,或者它将基于对象设置返回计算连接字符串。 如果显式设置,则填充 ServerConnection 对象中的所有属性以反映传入连接字符串。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException |
| ConnectTimeout |
在终止尝试并引发异常之前,等待与服务器的连接的时间长度(以秒为单位)。 默认值为 30 秒(与 Shiloh 相同)。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException |
| DatabaseName |
TBD |
| EncryptConnection |
是否在连接字符串中指定了“encrypt=true” |
| HostNameInCertificate |
证书中提供的主机名用于证书验证。 |
| Login |
用于连接到服务器的SQL Server登录名。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException |
| LoginSecure |
如果设置为 true,则使用Windows集成安全性,并忽略登录名和密码。 如果未设置,则使用 Sql Server 身份验证。 异常:ConnectionCannotBeChangedException |
| MaxPoolSize |
池中允许的最大连接数。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException |
| MinPoolSize |
池中维护的最小连接数。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException |
| MultipleActiveResultSets |
从连接启用 MARS。 默认值为 false。 |
| NetworkProtocol |
标识用于连接到SQL Server的客户端网络协议。 如果未指定网络并使用本地服务器,则使用共享内存。 如果未指定网络并使用远程服务器,则使用其中一种配置的客户端协议。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException |
| NonPooledConnection |
默认情况下,与SQL Server的所有连接都取自 ADO.NET 连接池。如果设置为 true,则允许用户创建非共用连接(在关闭时不会重复使用)。 异常:ConnectionCannotBeChangedException |
| PacketSize |
用于与 SQL Server 实例通信的网络数据包的大小(以字节为单位)。 默认值为 8192。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException |
| Password |
与 Login 一起使用以连接到服务器的密码。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException |
| PooledConnectionLifetime |
将连接返回到池时,其创建时间与当前时间进行比较,如果时间跨度(以秒为单位)超过连接生存期指定的值,则会销毁连接。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException |
| RequiresLogin |
如果 LoginSecure 和 Authentication 的当前值要求设置 Login 属性,则返回 true |
| ResetConnectionString |
告诉我们 ConnectionString 是否需要在 ConnectionManager 的 SqlConnectionObject 属性中重置。 |
| SecureConnectionString |
该属性将返回指定的用户连接字符串的 SecureString 版本,或者它将基于对象设置返回计算连接字符串。 如果显式设置,则填充 ServerConnection 对象中的所有属性以反映传入连接字符串。 异常:ConnectionCannotBeChangedException |
| SecurePassword |
与 Login 一起使用以连接到服务器的密码。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException |
| ServerCertificate |
要用于证书验证的服务器证书的路径。 |
| ServerInstance |
对象将连接到的SQL Server的名称。 如果未设置,则隐含本地服务器。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException |
| StrictEncryption |
是否在连接字符串中指定了“encrypt=strict”。 如果为 true,则忽略其 EncryptConnection 值。 |
| TrustServerCertificate |
指示客户端是否信任服务器证书 |
| WorkstationId |
连接到 SQL Server 的工作站的名称。 异常:ConnectionCannotBeChangedException InvalidPropertyValueException |
方法
| 名称 | 说明 |
|---|---|
| ThrowIfPropertyNotSet(String, String, Boolean) |
连接设置和创建 |
| ThrowIfPropertyNotSet(String, String) |
连接设置和创建 |
| ToString() |
连接设置和创建 |