РасширениеКонфигурации.Записать

Методы · Write

Сохраняет изменения в информационной базе.

Синтаксис

Записать(<Данные>)
Полное описание, параметры и ограничения

РасширениеКонфигурации.Записать (ConfigurationExtension.Write)

РасширениеКонфигурации (ConfigurationExtension)

Записать (Write)

Доступен, начиная с версии 8.3.6.

Синтаксис:
Записать(<Данные>)
Параметры:

<Данные> (необязательный)
Тип: ДвоичныеДанные.
Если объект РасширениеКонфигурации представляет собой только что созданное расширение, при создании которого не были переданы данные, параметр должен быть установлен. Если он не установлен, будет сгенерирована ошибка "При создании расширения необходимы данные".
При записи контролируется уникальность имени расширения. Если имя не уникально, генерируется ошибка "Имя расширения ... не уникально".
Запись расширений в безопасном режиме запрещена.
Значение по умолчанию: Неопределено.
Описание:

Сохраняет изменения в информационной базе.

Доступность:

Сервер, толстый клиент, внешнее соединение.

См. также:
МенеджерРасширенийКонфигурации, метод Создать

Использование в версии:

Доступен, начиная с версии 8.3.6.

Описание изменено в версии 8.3.22.

Методическая информация

Практические примеры

Создать, записать и удалить только своё учебное расширение

Административный синтаксис для нового собственного расширения с настоящим CFE, без поиска или замены существующих объектов.

Где и как запускать

Серверный обработчик своей учебной базы. Это пример синтаксиса: здесь 1С, файлы, базы и сеть не запускались.

Подготовка

  1. Только своя отдельная учебная ИБ. Вручную подготовьте безопасное CFE собственной учебной конфигурации, не содержащее обработчиков рабочих данных.

  2. Имя УчебноеРасширение должно быть свободным. Разрешения, совместимость расширения и ограничения платформы проверяются владельцем своего стенда до запуска.

Данные = Новый ДвоичныеДанные("C:\УчебныеДанные\учебное.cfe");
Расширение = РасширенияКонфигурации.Создать();
Расширение.Имя = "УчебноеРасширение";
Расширение.Записать(Данные);
Сообщить(Расширение.Имя);
Расширение.Удалить();
Сообщить("Удалён только созданный учебный объект расширения");

Разбор по шагам

  1. Читаем своё настоящее CFE.

  2. Создаём новый объект и записываем его двоичные данные.

  3. Удаляем только удержанный собственный новый объект.

Как проверить результат

  1. После записи читается имя УчебноеРасширение.

  2. Удалить не вызывается для объектов, найденных среди существующих расширений.

Ожидаемый результат

Контрольный результат описывает будущую ручную проверку в подготовленном учебном окружении. Выполнение в 1С здесь не проверялось.

На что обратить внимание

  1. Это будущие изменения учебной конфигурации, не атомарная операция. Ошибка может оставить расширение; код не обещает откат или автоматическое восстановление.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.