Загружает внешний компонент и подключает ее объекты к 1С:Предприятию. Объекты этого компонента должны быть построены по технологии внешних компонентов COM.
Синтаксис
ЗагрузитьВнешнююКомпоненту(<ИмяФайла>)Примеры платформы
Попытка
ЗагрузитьВнешнююКомпоненту("scanopos.dll");
Сообщить("Компонента scanopos загружена");
Исключение
Сообщить("Компонента scanopos не найдена!", СтатусСообщения.Внимание);
КонецПопыткиПолное описание, параметры и ограничения
Глобальный контекст.ЗагрузитьВнешнююКомпоненту (Global context.LoadAddIn)
Глобальный контекст (Global context)
ЗагрузитьВнешнююКомпоненту (LoadAddIn)
Доступен, начиная с версии 8.0.
Синтаксис:
ЗагрузитьВнешнююКомпоненту(<ИмяФайла>)
Параметры:
<ИмяФайла> (обязательный)
Тип: Строка.
Имя файла внешнего компонента.
Файл внешнего компонента не обязательно должен находиться в каталоге исполняемых файлов программы.
Описание:
Загружает внешний компонент и подключает ее объекты к 1С:Предприятию. Объекты этого компонента должны быть построены по технологии внешних компонентов COM.
Доступность:
Толстый клиент.
Примечание:
Внешние компоненты совместимы с компонентами 1С:Предприятия 7.7.
Пример:
Попытка
ЗагрузитьВнешнююКомпоненту("scanopos.dll");
Сообщить("Компонента scanopos загружена");
Исключение
Сообщить("Компонента scanopos не найдена!", СтатусСообщения.Внимание);
КонецПопытки
См. также:
Глобальный контекст, метод ПодключитьВнешнююКомпоненту
Глобальный контекст, событие ОбработкаВнешнегоСобытия
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Прежняя COM-компонента: загрузить библиотеку
ЗагрузитьВнешнююКомпоненту — прежний COM-механизм толстого клиента, не установка произвольной Native API библиотеки.
Где и как запускать
Синтаксический пример для толстого клиента Windows в своей учебной форме. Фрагмент без процедуры вставляется в тело обработчика. Здесь компоненты, COM и криптография не запускались.
Подготовка
В собственной тестовой среде подготовьте доверенную COM-компоненту scanopos.dll, совместимую с этим механизмом, разрядностью и Windows.
Имя взято из примера справки; файл не входит автоматически в платформу и здесь не скачивался.
Попытка
ЗагрузитьВнешнююКомпоненту("C:\УчебныеДанные\scanopos.dll");
Сообщить("Вызов загрузки COM-компоненты выполнен");
Исключение
Сообщить("Компонента не загружена");
КонецПопытки;Разбор по шагам
Проверьте происхождение и совместимость собственной библиотеки.
Вызовите загрузку по её полному учебному пути.
Отделите исключение загрузки от успешного завершения вызова.
Как проверить результат
Отсутствующий DLL даёт отказ, а не созданный фиктивный объект.
Это вызов только толстого клиента.
Ожидаемый результат
Показан синтаксис для указанной подготовки. Здесь код не запускался; реальные результаты и побочные эффекты проверяются только при будущем осознанном выполнении в своём учебном приложении.
На что обратить внимание
Загрузка внешнего кода имеет реальные риски и требует доверия к библиотеке.
Не подменяйте файл непроверенной DLL и не трактуйте исключение как успех.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.