Урок 30. Объект SqlConnection

Объект SqlConnection предназначен для установки соединения с SQL-сервером. В предыдущем разделе мы рассмотрели пример использования его конструктора, но это далеко не все, что следует знать об этом объекте. Тот же самый конструктор может применяться с дополнительными атрибутами, входящими в строку, которая объявляет свойства соединения. Впрочем, аналогичная строка может храниться в свойстве connectionstring, с рассмотрения которого мы и начнем обзор класса SqlConnection.

Connectionstring. Свойство типа string, в котором указываются параметры соединения с SQL-сервером. Строка состоит из пар "имя=значение", отделенных друг от друга символами точки с запятой. Естественно, возможные наименования параметров жестко заданы.

Впрочем, необходимо отметить, что большую часть этих параметров можно задать при помощи отдельных свойств.

Application Name. Параметр позволяет устанавливать наименование приложения, из которого и устанавливается соединение с SQL-сервером.
Connect Timeout или Connection Timeout. Значением этого параметра является целое число, указывающее продолжительность периода в секундах, в течение которого приложение будет ожидать ответа от SQL-сервера на свой запрос. Если в течение этого промежутка SQL-сервер не ответит приложению, соединение будет считаться не установленным. По умолчанию используется значение "15".
Connection Lifetime. Это значение позволяет указывать время, в течение которого будет действовать установленное соединение. Значением параметра является целое число, указывающее продолжительность жизни соединения в секундах. По истечении этого промежутка соединение будет принудительно закрыто системой. По умолчанию используется нулевое значение, которое указывает, что соединение имеет неограниченный срок жизни, и его будет закрывать само приложение.
current Language. Параметр позволяет указывать язык, на котором написано текстовое содержимое открываемой базы данных.
Data source или Server. Параметр позволяет указывать имя SQL-сервера, с которым устанавливается соединение. Если вместо имени необходимо указать сетевой адрес сервера, следует воспользоваться параметрами Address, Addr или Network Address.
Database или initial Catalog. Параметр указывает наименование базы данных, к которой происходит подключение.
Trusted_Connection или Integrated Security. Параметр позволяет указывать, что соединение будет устанавливаться по защищенному каналу. В качестве значений могут использоваться ключевые слова true или false. Если используется значение по умолчанию false, соединение устанавливается без соблюдения особых правил безопасности. Впрочем, в тех случаях, когда и SQL-сервер, и приложение находятся на одной и той же машине, нет смысла использовать защищенное соединение.
Max Pool size. Значением этого параметра является число, указывающее максимальное количество соединений, которое может одновременно поддерживать SQL-сервер. По умолчанию используется значение "100".
Min Pool size. Значением этого параметра является число, указывающее минимальное количество соединений, которое может одновременно поддерживать SQL-сервер. По умолчанию используется нулевое значение.
Password или Pwd. Параметр указывает пароль для регистрационного имени, под которым происходит соединение с базой данных.
user id. Параметр позволяет указывать регистрационное имя, под которым происходит соединение с базой данных.
connectionTimeout. Свойство типа integer. Свойство устанавливает продолжительность в секундах периода тайм-аута при соединении с базой данных. По умолчанию используется значение "15".
Database. Свойство типа string. В нем указывается наименование базы данных, к которой и присоединяется приложение.
DataSource. Свойство типа string. В нем указывается наименование, под которым зарегистрирован SQL-сервер, к которому присоединяется приложение.
Packetsize. Свойство типа integer, в котором указывается размер (в байтах) пакетов информации, пересылаемых от приложения к серверу и обратно. Значение свойства может находиться в пределах от 512 до 32767. По умолчанию используется значение "8192".
Serverversion. Свойство типа string, в котором отображается номер версии сервера, с которым устанавливается соединение.

Теперь перейдем к рассмотрению методов класса sgiconnection.

BeginTransaction. Метод вызывает запуск транзакции. Если использовать метод без параметров, то будет применена стандартная транзакция, запускаемая по умолчанию. Однако в качестве параметра можно передать строку, содержащую наименование транзакции. О работе с транзакциями будет более подробно рассказано в одном из следующих разделов этой главы.
ChangeDatabase. Метод позволяет изменить наименование базы данных, к которой при помощи объекта sqiconnection было присоединено приложение. В качестве параметра типа string методу передается наименование базы данных, к которой будет подключено текущее соединение.
close. Метод закрывает соединение.
CreateCommand. Метод позволяет создать экземпляр класса SqlCommand, который будет связан с открытым соединением.
open. Метод позволяет открыть соединение. При этом метод использует свойство Connectionstring для получения параметров открываемого соединения.

На этом мы заканчиваем рассмотрение структуры класса sqiconnection и переходим к рассмотрению класса SqlCommand.