Создает соединение с информационной базой 1С:Предприятия 8. Устанавливает соединение с информационной базой 1С:Предприятия 8 и возвращает ссылку на объект Внешнее соединение. Установка соединения выполняется по следующему алгоритму: 1. Внешнее соединение с требуемыми параметрами ищется в пуле соединений. Если найдено, то используется оно. 2. Если Внешнее соединение с требуемыми параметрами не найдено, то анализируется не исчерпан ли лимит по числу одновременно существующих соединений. Если не исчерпан, то создается новое Внешнее соединение. 3. Если лимит исчерпан, но при этом в пуле имеются неиспользуемые Внешнее соединение, то соединение, дольше всех находящееся в пуле, удаляется и создается новое Внешнее соединение. 4. Если никаким способом найти подходящее или создать новое Внешнее соединение не удалось, то происходит ожидание освобождения Внешнее соединение другим потоком, после чего весь процесс повторяется, начиная с пункта 1.
Синтаксис
Connect(<СтрокаСоединения>)Примеры платформы
cntr = Новый COMObject("V85.COMConnector");
connection = cntr.Connect("File=""c:\InfoBases\Trade"";
Usr=""Director"";")Полное описание, параметры и ограничения
Менеджер COM-соединений.Connect (COM connector.Connect)
Менеджер COM-соединений (COM connector)
Connect (Connect)
Доступен, начиная с версии 8.1.
Синтаксис:
Connect(<СтрокаСоединения>)
Параметры:
<СтрокаСоединения> (обязательный)
Тип: Строка.
Строка параметров (Строка соединения), используемая 1С:Предприятием для соединения с информационной базой.
Возвращаемое значение:
Тип: Внешнее соединение.
Описание:
Создает соединение с информационной базой 1С:Предприятия 8.
Устанавливает соединение с информационной базой 1С:Предприятия 8 и возвращает ссылку на объект Внешнее соединение.
Установка соединения выполняется по следующему алгоритму:
1. Внешнее соединение с требуемыми параметрами ищется в пуле соединений. Если найдено, то используется оно.
2. Если Внешнее соединение с требуемыми параметрами не найдено, то анализируется не исчерпан ли лимит по числу одновременно существующих соединений. Если не исчерпан, то создается новое Внешнее соединение.
3. Если лимит исчерпан, но при этом в пуле имеются неиспользуемые Внешнее соединение, то соединение, дольше всех находящееся в пуле, удаляется и создается новое Внешнее соединение.
4. Если никаким способом найти подходящее или создать новое Внешнее соединение не удалось, то происходит ожидание освобождения Внешнее соединение другим потоком, после чего весь процесс повторяется, начиная с пункта 1.
Доступность:
Интеграция.
Пример:
// Создается объект-коннектор
cntr = Новый COMObject("V85.COMConnector");
// создается объект COM-соединение
connection = cntr.Connect("File=""c:\InfoBases\Trade"";
Usr=""Director"";")
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Создать структуру через внешнее соединение
COM-подключение к своей файловой учебной базе создаёт объект в контексте внешнего соединения и преобразует значения в строки.
Где и как запускать
Толстый клиент своей учебной базы; фрагмент вставляется в обработчик своей команды. Здесь 1С не запускалась.
Подготовка
Подготовьте свою отдельную файловую учебную ИБ по указанному пути и зарегистрированный совместимый V85.COMConnector в Windows.
Строка соединения должна содержать реальные параметры своей ИБ. Если требуется аутентификация, используйте собственную учётную запись; пароль не выводите.
Менеджер = Новый COMОбъект("V85.COMConnector");
Соединение = Менеджер.Connect("File=""C:\УчебныеДанные\ВнешнееСоединение"";");
Данные = Соединение.NewObject("Структура");
Данные.Вставить("Количество", 2);
Сообщить(Соединение.String(Данные.Количество));
Сообщить(Соединение.String(42));Разбор по шагам
Connect возвращает действительное внешнее соединение.
NewObject создаёт структуру внутри этого соединения.
String преобразует собственные значения в текст для вывода.
Как проверить результат
Первое сообщение содержит 2, второе — 42.
При неверном пути подключения нет; это не повод подключаться к рабочей базе.
Ожидаемый результат
Контрольный результат описывает будущую ручную проверку в подготовленном учебном окружении. Выполнение в 1С здесь не проверялось.
На что обратить внимание
COM-методы описаны в контексте Интеграция. Этот BSL вызывающий пример предназначен для толстого клиента Windows.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.