ExternalDBase.Connect
| Connect (Соединиться с внешней базой данных) | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||
Функция выполяет соединение с базой данных по указанному адресу под указанным пользователем с заданным паролем. Если в процессе соединения произошла ошибка, функция вызовет исключение. Внимание: запись о новой внешней базе данных создается в памяти после успешного соединения, а не в момент создания объекта внешней базы данных. Это означает, что если соединение в процессе работы будет разорвано, и программа произведет его снова с помощью этой функции с тем же объектом, все объекты базы данных, оставшиеся в памяти, не будут принадлежать заново установленному соединению (т.е., будут внешними по отношению к нему).
Синтаксис
ExternalDBase.Connect(<Адрес базы данных (STRING)>,<Имя пользователя (STRING)>,<Пароль (STRING)>,<Дополнительные установки (INT)>=1)
Аргументы
<Адрес базы данных (STRING)>- Строка содержит адрес внешней базы данных, с которой необходимо установить соединение. Строка имеет формат:<IP-адрес>:<Порт>:<TCP пароль сервера>.<Имя пользователя (STRING)>- Имя пользователя для входа после установки соединения.<Пароль (STRING)>- Пароль пользователя для входа после установки соединения.<Дополнительные установки (INT)>- (необязательный аргумент) Число, задающее битовую маску с дополнительными установками соединения. Доступны следующие значения битов:- Бит 0 -- (рекомендуется, по умолчанию) Использовать сжатие данных при передаче пакетов.
- Бит 1 -- Устанавливает флаг "медленное соединение" для этой базы данных (см. IsSlowConnection).
- Бит 2 -- Производит соединение в режиме, когда регистрация на сервере и выход не создают записей login/logout в таблице журнала регистрации событий. Этот режим может быть полезен, чтобы не увеличивать базу данных при каждом соединении, если они происходят достаточно часто (см. ключ GhostLogin в статье Основной файл инициализации клиента).
Примеры
db2:=exdb.create();
db2.Connect("127.0.0.1:13521:TCPPassword","User","Password");
aEl:=db2.Ref.Контрагенты;
//Будет выведена единица
Message(db2.IsConnected());
db2.Disconnect;
//Будет выведен ноль
Message(db2.IsConnected());
//Будет вызвано исключение, так как соединение в данный момент не установлено
aEl.Find("Code","000000000603");
