Доступные версии документации

Класс 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 приведены в таблице 37.

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

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

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

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

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

Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter