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	Возвращает значение true, если текущие значения для LoginSecure и Authentication используют свойство Login (Унаследовано от 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	Возвращает значение true, если объект SqlConnection подключен к серверу. Это может возвращать значение 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	Пароль, используемый для входа для подключения к серверу. Исключения: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Унаследовано от ConnectionSettings)
PooledConnectionLifetime	Когда соединение возвращается в пул, время его создания сравнивается с текущим временем, а соединение уничтожается, если этот интервал времени (в секундах) превышает значение, указанное в течение времени существования подключения. Исключения: ConnectionCannotBeChangedException InvalidPropertyValueException (Унаследовано от ConnectionSettings)
ProductVersion	Возвращает свойство сервера ProductVersion для этого подключения.
RequiresLogin	Возвращает значение true, если текущие значения для LoginSecure и authentication требуют задания свойства Login (Унаследовано от ConnectionSettings)
ResetConnectionString	Сообщает нам, нужно ли сбросить ConnectionString в свойстве SqlConnectionObject ConnectionManager или нет. (Унаследовано от ConnectionSettings)
SecureConnectionString	Свойство возвращает версию SecureString пользователя, указанного строка подключения, или возвращает вычисляемый строка подключения на основе параметров объекта. Если явно задано, все свойства объекта ServerConnection будут заполнены, чтобы отразить переданный в строка подключения. Исключения: ConnectionCannotBeChangedException (Унаследовано от ConnectionSettings)
SecurePassword	Пароль, используемый для входа для подключения к серверу. Исключения: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Унаследовано от ConnectionSettings)
ServerCertificate	Путь к сертификату сервера, который будет использоваться для проверки сертификатов. (Унаследовано от ConnectionSettings)
ServerInstance	Имя SQL Server объект будет подключаться. Если этот параметр не задан, то подразумевается локальный сервер. Исключения: ConnectionCannotBeChangedException InvalidPropertyValueException (Унаследовано от ConnectionSettings)
ServerVersion	Возвращает основной номер версии SQL Server. Т.е. 8 для SQL Server 2000. Исключения: ConnectionFailureException
SqlConnectionObject	Возвращает ссылку на объект SqlConnection, используемый объектом ConnectionContext. Это всегда должно возвращать допустимый объект sqlConnection с последним допустимым набором ConnectionString. Исключения: PropertyNotAvailableException
StrictEncryption	Указывает ли значение encrypt=strict в строка подключения. Если значение true, значение EncryptConnection игнорируется. (Унаследовано от ConnectionSettings)
TrustServerCertificate	Указывает, доверяет ли клиент сертификату сервера. (Унаследовано от ConnectionSettings)
WorkstationId	Имя рабочей станции, подключающейся к SQL Server. Исключения: ConnectionCannotBeChangedException InvalidPropertyValueException (Унаследовано от ConnectionSettings)

Методы

Имя	Описание
CheckServerVersion(ServerVersion)	Проверьте, подключается ли мы к поддерживаемой версии сервера. блокировать <= 7.0 в ServerConnection.
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	параметры подключения и создание