ConnectionSettings 类

定义

连接设置和创建

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()

连接设置和创建

适用于