ConnectionManager 类

定义

命名空间:

Microsoft.SqlServer.Management.Common

程序集:

Microsoft.SqlServer.ConnectionInfo.dll

包:

Microsoft.SqlServer.SqlManagementObjects v172.64.0

连接设置和创建

public abstract class ConnectionManager : Microsoft.SqlServer.Management.Common.ConnectionSettings

type ConnectionManager = class
    inherit ConnectionSettings

Public MustInherit Class ConnectionManager
Inherits ConnectionSettings

继承

Object

ConnectionSettings

ConnectionManager

派生

Microsoft.SqlServer.Management.Common.ServerConnection

字段

名称	说明
NoConnectionTimeout	无限等待 (继承自 ConnectionSettings)

属性

名称	说明
AcceptsLogin	如果 LoginSecure 和 Authentication 的当前值使用 Login 属性，则返回 true (继承自 ConnectionSettings)
AccessToken	连接设置和创建 (继承自 ConnectionSettings)
ApplicationIntent	连接有效值的应用程序意向为 ReadWrite 和 ReadOnly (继承自 ConnectionSettings)
ApplicationName	应用程序的名称。 如果未提供任何应用程序名称，则为“SQL 管理”。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException (继承自 ConnectionSettings)
Authentication	连接的身份验证类型 (继承自 ConnectionSettings)
AutoDisconnectMode	连接设置和创建
CapturedSql	连接设置和创建
ConnectAsUser	如果设置为 true，将使用指定用户的凭据建立连接。 这将假定模拟，但 LoginSecure 标志和登录名和密码字段不会受到影响。 此设置仅在Windows可用。 (继承自 ConnectionSettings)
ConnectAsUserName	指定创建模拟连接时使用的Windows用户。 用户必须具有交互式登录权限。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (继承自 ConnectionSettings)
ConnectAsUserPassword	指定创建模拟连接时使用的Windows用户的密码。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (继承自 ConnectionSettings)
ConnectionProtocol	连接协议。
ConnectionString	该属性将返回指定的用户连接字符串，或者它将基于对象设置返回计算连接字符串。 如果显式设置，则填充 ServerConnection 对象中的所有属性以反映传入连接字符串。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException (继承自 ConnectionSettings)
ConnectTimeout	在终止尝试并引发异常之前，等待与服务器的连接的时间长度（以秒为单位）。 默认值为 30 秒（与 Shiloh 相同）。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException (继承自 ConnectionSettings)
CurrentDatabase	返回当前数据库上下文。
DatabaseEngineEdition	数据库引擎的版本
DatabaseEngineType	返回SQL Server的数据库引擎类型。 异常：ConnectionFailureException
DatabaseName	TBD (继承自 ConnectionSettings)
EncryptConnection	是否在连接字符串中指定了“encrypt=true” (继承自 ConnectionSettings)
HostNameInCertificate	证书中提供的主机名用于证书验证。 (继承自 ConnectionSettings)
HostPlatform	服务器的主机平台（Linux/Windows/etc）
InUse	如果对象至少与服务器连接了一次，则返回 true。 如果为 true，则不允许再更改属性，当属性发生更改时，将引发 ConnectionCannotBeChangedException。
IsContainedAuthentication	如果数据库引擎使用包含的身份验证进行身份验证，则返回 true。 异常：ConnectionFailureException
IsForceDisconnected	指示连接已强制断开连接
IsOpen	如果 SqlConnection 对象与服务器连接，则返回 true。 对于非入池连接，这只能返回 true，因为池连接始终在操作后直接关闭。
LockTimeout	LockTimeout 是锁定超时（以秒为单位）。 默认 -1 无限期。 对于所有其他负数，将引发 InvalidPropertyValueException。 正 LockTimeout 将乘以 1000，然后用于“SET LOCK_TIMEOUT”设置。
Login	用于连接到服务器的SQL Server登录名。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (继承自 ConnectionSettings)
LoginSecure	如果设置为 true，则使用Windows集成安全性，并忽略登录名和密码。 如果未设置，则使用 Sql Server 身份验证。 异常：ConnectionCannotBeChangedException (继承自 ConnectionSettings)
MaxPoolSize	池中允许的最大连接数。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException (继承自 ConnectionSettings)
MinPoolSize	池中维护的最小连接数。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException (继承自 ConnectionSettings)
MultipleActiveResultSets	从连接启用 MARS。 默认值为 false。 (继承自 ConnectionSettings)
NetworkProtocol	标识用于连接到SQL Server的客户端网络协议。 如果未指定网络并使用本地服务器，则使用共享内存。 如果未指定网络并使用远程服务器，则使用其中一种配置的客户端协议。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException (继承自 ConnectionSettings)
NonPooledConnection	默认情况下，与SQL Server的所有连接都取自 ADO.NET 连接池。如果设置为 true，则允许用户创建非共用连接（在关闭时不会重复使用）。 异常：ConnectionCannotBeChangedException (继承自 ConnectionSettings)
PacketSize	用于与 SQL Server 实例通信的网络数据包的大小（以字节为单位）。 默认值为 8192。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException (继承自 ConnectionSettings)
Password	与 Login 一起使用以连接到服务器的密码。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (继承自 ConnectionSettings)
PooledConnectionLifetime	将连接返回到池时，其创建时间与当前时间进行比较，如果时间跨度（以秒为单位）超过连接生存期指定的值，则会销毁连接。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException (继承自 ConnectionSettings)
ProductVersion	获取此连接的 ProductVersion 服务器属性
RequiresLogin	如果 LoginSecure 和 Authentication 的当前值要求设置 Login 属性，则返回 true (继承自 ConnectionSettings)
ResetConnectionString	告诉我们 ConnectionString 是否需要在 ConnectionManager 的 SqlConnectionObject 属性中重置。 (继承自 ConnectionSettings)
SecureConnectionString	该属性将返回指定的用户连接字符串的 SecureString 版本，或者它将基于对象设置返回计算连接字符串。 如果显式设置，则填充 ServerConnection 对象中的所有属性以反映传入连接字符串。 异常：ConnectionCannotBeChangedException (继承自 ConnectionSettings)
SecurePassword	与 Login 一起使用以连接到服务器的密码。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (继承自 ConnectionSettings)
ServerCertificate	要用于证书验证的服务器证书的路径。 (继承自 ConnectionSettings)
ServerInstance	对象将连接到的SQL Server的名称。 如果未设置，则隐含本地服务器。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException (继承自 ConnectionSettings)
ServerVersion	返回SQL Server的主要版本号。 i. 8 for SQL Server 2000. 异常：ConnectionFailureException
SqlConnectionObject	返回对 ConnectionContext 对象使用的 SqlConnection 对象的引用。 这应始终返回具有最新有效 ConnectionString 集的有效 sqlConnection 对象。 异常：PropertyNotAvailableException
StrictEncryption	是否在连接字符串中指定了“encrypt=strict”。 如果为 true，则忽略其 EncryptConnection 值。 (继承自 ConnectionSettings)
TrustServerCertificate	指示客户端是否信任服务器证书 (继承自 ConnectionSettings)
WorkstationId	连接到 SQL Server 的工作站的名称。 异常：ConnectionCannotBeChangedException InvalidPropertyValueException (继承自 ConnectionSettings)

方法

名称	说明
CheckServerVersion(ServerVersion)	检查我们是否正在连接到受支持的服务器版本。 block off <= ServerConnection 中的 7.0。
Connect()	创建与SQL Server的实际连接。 如果已连接，则忽略。 调用此方法是可选的，因为需要时将打开连接。 异常：ConnectionFailureException
Disconnect()	关闭与SQL Server的连接。 如果已断开连接，则忽略。 异常：ConnectionFailureException
ExecuteTSql(ConnectionManager+ExecuteTSqlAction, Object, DataSet, Boolean)	使用适当的方法执行 T-SQL，具体取决于作为参数传递的操作信息。
ForceDisconnected()	强制断开连接并确保无法再次重新打开连接
ThrowIfPropertyNotSet(String, String, Boolean)	连接设置和创建 (继承自 ConnectionSettings)
ThrowIfPropertyNotSet(String, String)	连接设置和创建 (继承自 ConnectionSettings)
ToString()	连接设置和创建 (继承自 ConnectionSettings)

活动

名称	说明
InfoMessage	当SQL Server返回警告或信息性消息时发生。 使用 SqlClient.SqlInfoMessageEventHandler。
RemoteLoginFailed	当服务器需要连接到远程服务器并且登录失败时调用
ServerMessage	当SQL Server返回警告或信息性消息时发生。 使用 SqlClient.SqlInfoMessageEventHandler。
StateChange	在连接状态发生更改时发生。 使用 System.Data.StateChangeEventHandler。
StatementExecuted	连接设置和创建