Устанавливает начальные параметры соединения с СУБД ЛИНТЕР. Значение по умолчанию – пустая строка.

Строка подключения состоит из выражений вида < параметр >=< значение >, разделённых точкой с запятой.

Параметры строки подключений

Data Source=< имя сервера >

Имя ЛИНТЕР-сервера, с которым должно быть установлено соединение. Параметр необязательный. Параметр надо указать, если необходимо установить соединение с удалённым ЛИНТЕР-сервером (его имя должно быть прописано в конфигурационном файле nodetab, используемом сетевым драйвером клиента, см. документ «СУБД ЛИНТЕР. Сетевые средства»).

Если параметр не указан или указан параметр Data Source=LOCAL, то клиентское приложение сначала пытается отослать сообщение локальному ядру СУБД по механизму межпроцессного обмена с идентификатором, заданным переменной окружения LINTER_MBX. Если локальное ядро не запущено или использует другой идентификатор обмена, то клиентское приложение пытается отослать сообщение сетевому драйверу клиента с идентификатором, заданным переменной окружения NET_MBX (см. документ «СУБД ЛИНТЕР. Архитектура СУБД», пункт «Механизм взаимодействия клиентских приложений с ядром СУБД»).

БД может быть создана с помощью следующих средств:

После создания БД надо создать системные представления, которые необходимы для работы ADO.NET-провайдера (см. пункт «Подготовка БД»).

User ID=< имя пользователя >

Имя зарегистрированного в БД пользователя. Параметр необязательный для пользователей со встроенной в ОС аутентификацией (см. документ «СУБД ЛИНТЕР. Справочник по SQL», конструкция CREATE USER с опцией PROTOCOL).

Password=< пароль >

Пароль пользователя. Параметр необязательный для пользователей, созданных c опцией IDENTIFIED BY SYSTEM или PROTOCOL (см. документ «СУБД ЛИНТЕР. Справочник по SQL», конструкция CREATE USER).

Integrated Security=< аутентификация >

Свойство определяет, может ли источник данных требовать предоставления ему регистрационных (учетных) данных (имя пользователя и пароль).

Допустимые значения:

Параметр необязательный (значение по умолчанию false).

Если будет указано одновременно Integrated Security=true, а также имя пользователя и пароль, то значение Integrated Security имеет преимущество (при установке соединения вместо имени пользователя и пароля будут отправлены пустые строки).

Persist Security Info=< отображение регистрационных данных >

Свойство определяет, разрешено ли источнику данных возвращать значения параметров строки подключения:

Допустимые значения:

IsolationLevel=< уровень изоляции >

Задает уровень изоляции транзакций (см. документ «СУБД ЛИНТЕР. Справочник по SQL»). Параметр необязательный.

Допустимые значения:

Autocommit=< режим канала >

Устанавливает (значение true)/отменяет (значение false) режим автоматического фиксирования (COMMIT) изменений в БД по данному соединению.

Значение по умолчанию true (т.е. для фиксирования изменений в БД явно выполнять SQL-оператор COMMIT не требуется).

Minimum Pool Size=< число >

Минимальное разрешенное количество подключений в пуле. Значение по умолчанию 0.

Пул соединений снижает количество открытий новых соединений, т.к. пул поддерживает владение физическим соединением. Он управляет соединениями с помощью поддержания набора активных соединений для каждой конфигурации данного соединения. Каждый раз, когда пользователь вызывает метод Open в соединении, организатор пулов ищет в пуле доступное соединение. Если соединение пула доступно, вместо открытия нового соединения он возвращает его инициатору открытия соединения. При вызове приложением метода Close в соединении вместо закрытия организатор пулов возвращает его в набор активных соединений пула. После возвращения соединения в пул оно готово к повторному использованию при следующем вызове метода Open.

Maximum Pool Size=< число >

Максимальное разрешенное количество подключений в пуле. Значение по умолчанию 100.

ConnectionTimeout=< число >

Тайм-аут соединения (неотрицательное целочисленное значение). Задает временной промежуток (в сек), в течение которого провайдер будет ожидать успешное завершение соединения с источником данным. Если в заданный интервал времени соединение установлено не будет, генерируется исключение.

Параметр необязательный (значение по умолчанию 15 сек).

Channel Priority=< число >

Приоритет канала для данного соединения (см. документ «СУБД ЛИНТЕР. Интерфейс нижнего уровня»). Параметр необязательный (значение по умолчанию 0).

Messages Language=< язык сообщений >

Язык информационных и диагностических сообщений, выдаваемых провайдером на консоль.

Допустимые значения:

Параметр необязательный (значение по умолчанию en/US).

Charset=< кодовая страница >|DEFAULT

Задает имя кодовой страницы, используемой для представления символьных данных в процессе обмена данными между ЛИНТЕР-сервером и клиентским приложением.

Параметр необязательный (значение по умолчанию Encoding.Default.WebName).

Для ЛИНТЕР-сервера заданная кодировка должна быть определена в поле NAME системной таблицы $$$CHARSET, пример: Charset=CP1251 или Charset=UTF-8 (см. документы «СУБД ЛИНТЕР. Системные таблицы и представления» и «СУБД ЛИНТЕР. Справочник по SQL»).

Если имя кодовой страницы неверное, то будет использована кодовая страница DEFAULT (только первые 127 символов).

Декларация

public override string ConnectionString {set; get;};

Значение свойства

Строка соединения с источником данных.

Исключения

Примеры

// прочитать свойство (получить текст строки подключения)
string s = con.ConnectionString;
// установить свойство (устанавливается новая полная строка)
con.ConnectionString = "User ID=SYSTEM;Password=MANAGER8;Data Source=LOCAL";
// изменить свойство (чтобы изменить некоторые параметры необходимо менять сразу всю строку)
con.ConnectionString = "User ID=SYS;Password=MANAGER8;Data Source=LOCAL";