CreateConnectionStringBuilder
Метод создает объект типа LinterDbConnectionStringBuilder
.
Класс LinterDbConnectionStringBuilder
позволяет разработчикам приложений задавать в исходном коде программы произвольные пары «ключ/значение» и передавать полученную результирующую строку подключения провайдеру данных.
Разработчик приложения может создавать, назначать и изменять строки подключения. Для этого построитель строк подключения предоставляет строго типизированные свойства, соответствующие известным парам «ключ/значение». Чтобы обеспечить поддержку неизвестных значений, разработчики приложений могут также предоставлять произвольные пары «ключ/значение».
Класс LinterDbConnectionStringBuilder
также может использоваться для управления строками подключения, которые хранятся в файле конфигурации приложения.
Разработчики могут создавать строки подключения, используя либо строго типизированный класс построителя строк подключения LinterDbConnectionStringBuilder
, либо класс DbConnectionStringBuilder
.
Класс LinterDbConnectionStringBuilder
не выполняет проверок на наличие допустимых пар «ключ/значение». Следовательно, он допускает создавать недопустимые строки подключения.
Синтаксис
public override DbConnectionStringBuilder CreateConnectionStringBuilder();
Возвращаемое значение
Объект LinterDbConnectionStringBuilder
типа System.Data.LinterClient.LinterDbConnectionStringBuilder
.
Исключения
Отсутствуют.
Пример
// C# using System; using System.Data; using System.Data.Common; using System.Data.LinterClient; class CreateConnectionStringBuilderSample { static void Main() { DbProviderFactory factory = DbProviderFactories.GetFactory("System.Data.LinterClient"); DbConnectionStringBuilder builder = factory.CreateConnectionStringBuilder(); // Класс DbConnectionStringBuilder не зависит от баз данных, поэтому допускает // конструирование любых произвольных строк подключения. builder.ConnectionString = "User ID=SYSTEM;Password=MANAGER8;Data Source=LOCAL"; // Установка уровня изоляции транзакций. builder.Add("Isolation Level", IsolationLevel.ReadCommitted); // С помощью класса DbConnectionStringBuilder может быть сформировано свойство // ConnectionString. Console.WriteLine(builder.ConnectionString); // Используем тот же самый объект DbConnectionStringBuilder для создания объекта // LinterDbConnection. builder.Clear(); builder.Add("User ID", "SYSTEM"); builder.Add("Password", "MANAGER8"); builder.Add("Data Source", "LOCAL"); LinterDbConnection linterDbConnection = new LinterDbConnection(builder.ConnectionString); Console.WriteLine(linterDbConnection.ConnectionString); // Передавая объекту DbConnectionStringBuilder готовую строку подключения, можно // получить и изменить любой элемент. builder.ConnectionString = "User ID=SYSTEM;Password=MANAGER8;Data Source=LOCAL"; builder["Data Source"] = "SERV1"; builder.Remove("User ID"); // Обратите внимание, что вызов метода Remove для несуществующего элемента, не // приводит к ошибке. builder.Remove("BadItem"); // Установка значения добавляет новый элемент при необходимости. builder["Charset"] = "CP1251"; builder.Remove("password"); builder["User ID"] = "Hello"; Console.WriteLine(builder.ConnectionString); } }