ConnectionString
Устанавливает начальные параметры соединения с СУБД ЛИНТЕР. Значение по умолчанию – пустая строка.
Строка подключения состоит из выражений вида < параметр >=< значение >, разделённых точкой с запятой.
Параметры строки подключений
Data Source=< имя сервера >
Имя ЛИНТЕР-сервера, с которым должно быть установлено соединение. Параметр необязательный. Параметр надо указать, если необходимо установить соединение с удалённым ЛИНТЕР-сервером (его имя должно быть прописано в конфигурационном файле nodetab
, используемом сетевым драйвером клиента, см. документ «Сетевые средства»).
Если параметр не указан или указан параметр Data Source=LOCAL, то клиентское приложение сначала пытается отослать сообщение локальному ядру СУБД по механизму межпроцессного обмена с идентификатором, заданным переменной окружения LINTER_MBX. Если локальное ядро не запущено или использует другой идентификатор обмена, то клиентское приложение пытается отослать сообщение сетевому драйверу клиента с идентификатором, заданным переменной окружения NET_MBX (см. документ «Архитектура СУБД», пункт «Механизм взаимодействия клиентских приложений с ядром СУБД»).
БД может быть создана с помощью следующих средств:
-
gendb (см. документ «Создание и конфигурирование базы данных»);
-
linadm (см. документ «Сетевой администратор»);
После создания БД надо создать системные представления, которые необходимы для работы 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=MANAGER8;Data Source=LOCAL"; // изменить свойство (чтобы изменить некоторые параметры необходимо менять сразу всю строку) con.ConnectionString = "User ID=SYS;Password=MANAGER8;Data Source=LOCAL";