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

ConnectionString

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

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

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

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

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

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

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

  • gendb (см. документ «СУБД ЛИНТЕР. Создание и конфигурирование базы данных»);

  • linadm (см. документ «СУБД ЛИНТЕР. Сетевой администратор»);

  • snmp (см. документ «СУБД ЛИНТЕР. Удалённое управление компонентами СУБД»).

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

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

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

Password=<пароль>

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

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

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

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

  • false – источник данных должен запрашивать регистрационные данные;

  • true – регистрационные данные в строке подключения можно не указывать (используется встроенная в ОС аутентификация).

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

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

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

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

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

  • false (настоятельно рекомендуется) – важные сведения (например, пароль) не возвращаются как часть строки подключения. При сбросе строки подключения сбрасываются также все ее значения, включая пароль. Параметр необязательный (значение по умолчанию false);

  • true – предоставление регистрационных данных не запрещается.

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

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

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

  • Optimistic;

    Примечание

    Режим OPTIMISTIC устарел. Применять не рекомендуется.

  • Pessimistic (значение по умолчанию).

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 – английский;

  • ru или RU – русский.

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

Примечание

В текущей версии провайдера параметр не поддерживается. Зарезервирован для будущего применения.

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

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

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

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

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

Декларация
public override string ConnectionString {set; get;};
Значение свойства

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

Исключения
ArgumentException Не поддерживается ключевое слово, указанное в строке подключения или недопустимое значение в строке подключения (особенно, когда логическое значение или числовое значение ожидалось, но так и не было предоставлено).
Примеры
// прочитать свойство (получить текст строки подключения)
string s = con.ConnectionString;
// установить свойство (устанавливается новая полная строка)
con.ConnectionString = "User ID=SYSTEM;Password=MANAGER;Data Source=LOCAL";
// изменить свойство (чтобы изменить некоторые параметры необходимо менять сразу всю строку)
con.ConnectionString = "User ID=SYS;Password=MANAGER;Data Source=LOCAL";
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter