Метод КОЛЛЕКЦИЯ_ОБЪЕКТОВ.ПОДКЛЮЧИТЬ
Метод ПОДКЛЮЧИТЬ позволяет связать значение типа КОЛЛЕКЦИЯ_ОБЪЕКТОВ с ранее созданной именованной выборкой. Выборка может быть создана в другой программе И++, но в той же клиентской сессии.
ФУНКЦИЯ ЛОГИКА: ПОДКЛЮЧИТЬ(СТРОКА: имя; МАСКА_АН: маска = МАСКА_АН[])
Параметры
- имя
- Имя выборки, которое ранее указывалось как параметр метода ПОСТРОИТЬ.
- маска
- Маска для считывания объектов аналитики из коллекции. Эта маска используется при передаче данных с сервера в клиентский кэш. См. метод СЧИТАТЬ.
Возвращаемое значение
ДА – в случае успеха, НЕТ – в случае ошибки.
Обрабатывать результат можно с помощью функции ПОСЛ_ОШИБКА. Если коллекции с указанным именем нет, то метод возвращает НЕТ, а ПОСЛ_ОШИБКА возращает код -1.
Замечание 1.
Метод ПОДКЛЮЧИТЬ освобождает ресурсы, занятые прежней выборкой. Если прежняя выборка была именованной, то она продолжает существовать.
Замечание 2.
Именованная выборка не освобождается при разрушении значения типа КОЛЛЕКЦИЯ_ОБЪЕКТОВ. Если выборка более не нужна, то ее следует освободить вызовом функции УДАЛИТЬ_КОЛЛЕКЦИЮ_ОБЪЕКТОВ.
Замечание 3.
Если клиентская сессия была прервана администратором или сервер был перезапущен, то все именованные выборки удаляются, а метод ПОДКЛЮЧИТЬ будет возвращать НЕТ. В этом случае, для восстановления доступа к данным, надо снова создать выборку методом ПОСТРОИТЬ.