ЛИНТЕР

Класс DbConnectionStringBuilder

Класс DbConnectionStringBuilder предназначен для создания и управления содержимым строк подключения, которые используются классом DbConnection.

Класс DbConnectionStringBuilder предоставляет ограниченный внутренний набор пар «ключ/значение». Если в строке подключения отсутствует значение какого-либо параметра, то в процессе соединения с ЛИНТЕР-сервером используется значение по умолчанию. При извлечении свойства ConnectionString того или иного объекта строка содержит только такие пары «ключ/значение», в которых «значение» отличается от стандартного значения.

Ключи строки подключения:

DataSource=<имя сервера>;
User ID=<имя пользователя>;
Password=<пароль>;
Persist Security Info=<аутентификации>;
IsolationLevel=<уровень изоляции>;
Autocommit=<режим канала>;
Minimum Pool Size=<число>;
Maximum Pool Size=<число>;
ConnectionTimeout=<число>;
Channel Priority=<число>;
Messages Language=<язык сообщений>;
Charset=<кодировка>.

Формат строки подключения приведён в пункте «ConnectionString».

Конструкторы класса DbConnectionStringBuilder приведены в таблице 35.

Таблица 35. Конструкторы класса DbConnectionStringBuilder

Конструктор	Описание
`LinterDbConnectionStringBuilder`	Создает новый экземпляр класса LinterDbConnectionStringBuilder с параметрами соединения по умолчанию.
`LinterDbConnectionStringBuilder(String)`	Создает новый экземпляр класса LinterDbConnectionStringBuilder на основе заданной строки подключения.

Свойства класса DbConnectionStringBuilder приведены в таблице 36.

Таблица 36. Свойства класса DbConnectionStringBuilder

Свойство	Описание
BrowsableConnectionString	Предоставляет/устанавливает видимость свойства ConnectionString в конструкторах.
ConnectionString	Предоставляет/устанавливает строку подключения, связанную с DbConnectionStringBuilder.
Count	Предоставляет текущее количество ключей, содержащихся в строке подключения.
DataSource	Предоставляет/устанавливает имя сервера источника данных, к которому осуществляется подключение.
IsFixedSize	Предоставляет информацию о возможности добавления новых ключей в строку подключения.
IsReadOnly	Предоставляет информацию о возможности изменения объекта LinterDbConnectionStringBuilder (т.е. является коллекция «только для чтения» или нет).
Item	Предоставляет/устанавливает значение заданного ключа строки подключения.
Keys	Предоставляет список ключей, задействованных в строке подключения.
Password	Предоставляет/устанавливает пароль текущего пользователя БД источника данных.
PersistSecurityInfo	Предоставляет или устанавливает режим отображения пароля в строке подключения.
UserID	Предоставляет/устанавливает имя пользователя, которое должно использоваться при подключении к серверу источника данных.
Values	Предоставляет массив значений всех ключей текущей строки подключения.

Методы класса DbConnectionStringBuilder приведены в таблице 37.

Таблица 37. Методы класса DbConnectionStringBuilder

Метод	Описание
`Add`	Добавляет параметр подключения (пару «ключ/значение») в текущую строку подключения.
`AppendKeyValuePair(StringBuilder, String, String)`	Добавляет пару «ключ/значение» в массив элементов «ключ/значение» (в объект StringBuilder)
`AppendKeyValuePair(StringBuilder, String, String, Boolean)`	Добавляет элемент «ключ/значение» в указанную строку подключения с заданным разделителем элементов «ключ/значение».
`Clear`	Удаляет содержимое текущей строки подключения.
`ContainsKey`	Проверяет поддержку ADO.NET-провайдером в строке подключения указанного ключа.
`EquivalentTo`	Сравнивает две строки подключения.
`Remove`	Удаляет элемент «ключ/значение» из строки подключения.
`ShouldSerialize`	Проверяет наличие указанного ключа в строке подключения.
`TryGetValue`	Предоставляет значение указанного ключа строки подключения.