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

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=MANAGER;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", "MANAGER");
    builder.Add("Data Source", "LOCAL");
    LinterDbConnection linterDbConnection = new
      LinterDbConnection(builder.ConnectionString);
    Console.WriteLine(linterDbConnection.ConnectionString);
    // Передавая объекту DbConnectionStringBuilder готовую строку подключения, можно
    // получить и изменить любой элемент.
    builder.ConnectionString = "User ID=SYSTEM;Password=MANAGER;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);
  }
}
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter