Что такое экземпляр объекта в 1С

Экземпляр объекта в 1С — это конкретное значение в памяти, созданное на основе описания (типа, класса или объекта метаданных). Тип задаёт структуру: какие у значения будут свойства, методы и табличные части. Экземпляр — это уже «живое» значение этого типа, с которым код работает в конкретный момент: заполняет реквизиты, вызывает методы, записывает в базу.

Простая аналогия: тип — это чертёж, экземпляр — построенное по нему здание. По одному чертежу можно построить сколько угодно зданий, и каждое будет отдельным объектом со своим адресом. Так же в 1С: по описанию справочника «Номенклатура» создаются тысячи элементов, и каждый из них — отдельный экземпляр со своим кодом, наименованием и ссылкой.

Путаница возникает потому, что термин «экземпляр объекта» в 1С употребляется в двух смежных смыслах. В прикладном смысле это конкретная запись в базе данных — например, элемент справочника или документ. В программном смысле это значение встроенного языка, созданное в памяти: объект типа «СправочникОбъект», «ДокументОбъект», структура, массив, COM-объект. Ниже разберём оба смысла и покажем, как они связаны.

Тип и экземпляр: в чём разница

Тип — это описание. Например, «СправочникСсылка.Номенклатура» говорит платформе: значение этого типа указывает на элемент справочника «Номенклатура» и имеет предопределённый набор свойств. Сам тип нельзя «заполнить» или «записать» — он только определяет правила.

Экземпляр — это значение, существующее в памяти или в базе данных. Когда вы создаёте новый элемент справочника в режиме предприятия, вы создаёте экземпляр. Когда в коде выполняется Новый Структура — тоже создаётся экземпляр, только не прикладного объекта, а объекта встроенного языка.

Проверить тип значения можно функцией ТипЗнч(): она возвращает тип переданного экземпляра. Это стандартный приём в условиях, когда поведение кода зависит от того, какой именно объект пришёл на вход.

Экземпляры прикладных объектов: ссылка и объект

Ключевая тонкость 1С: у прикладного объекта (справочника, документа) экземпляр существует в двух формах — ссылка и объект. Ссылка (СправочникСсылка, ДокументСсылка) — это лёгкий идентификатор записи в базе. Она позволяет читать реквизиты, но не менять их. Объект (СправочникОбъект, ДокументОбъект) — это редактируемое представление записи в памяти, которое можно изменить и записать.

Получить объект из ссылки можно методом ПолучитьОбъект(). При этом платформа загружает данные из базы в память и создаёт новый экземпляр объекта. Два вызова ПолучитьОбъект() для одной ссылки дадут два разных экземпляра в памяти — изменения в одном не появятся в другом автоматически.

ЭлементОбъект = СсылкаНаЭлемент.ПолучитьОбъект();
ЭлементОбъект.Наименование = "Новое наименование";
ЭлементОбъект.Записать();

После Записать() состояние объекта переносится в базу данных. До записи все изменения существуют только в памяти и будут потеряны при завершении сеанса.

Экземпляры объектов встроенного языка

Кроме прикладных объектов, экземпляры создаются для типов встроенного языка: структуры, соответствия, массивы, таблицы значений, запросы, построители отчётов, COM-объекты. Они существуют только во время выполнения кода и не сохраняются в базе сами по себе.

Создание такого экземпляра обычно выполняется конструктором Новый:

Данные = Новый Структура("Имя, Возраст", "Иван", 30);
Список = Новый Массив;
Таблица = Новый ТаблицаЗначений;

Каждый вызов Новый создаёт независимый экземпляр. Две структуры с одинаковым содержимым — это два разных объекта в памяти. При присваивании переменной Б = А для таких типов копируется ссылка на тот же экземпляр, а не его содержимое: изменив Б, вы измените и А. Это частая причина неочевидных ошибок.

А = Новый Структура("Количество", 1);
Б = А; // Б указывает на тот же экземпляр
Б.Количество = 5;
// А.Количество теперь тоже равно 5

Как создать экземпляр: типовые сценарии

Новый элемент справочника или документ

Для создания новой записи используется менеджер объекта: Справочники.Номенклатура.СоздатьЭлемент() или Документы.РеализацияТоваровУслуг.СоздатьДокумент(). Метод возвращает экземпляр объекта в памяти, который ещё не существует в базе — у него нет ссылки до первой записи.

1. 1
   Вызовите метод создания: Справочники.Имя.СоздатьЭлемент() или Документы.Имя.СоздатьДокумент()
2. 2
   Заполните обязательные реквизиты и табличные части полученного объекта
3. 3
   Вызовите Записать() — для документа при необходимости Записать(РежимЗаписиДокумента.Проведение)
4. 4
   Проверьте, что у объекта появилась ссылка: объект.Ссылка больше не пустая

Экземпляр по описанию типа

Иногда тип известен только в виде строки или значения типа — например, при универсальных обработках. Тогда экземпляр создаётся через Новый(Тип) или через менеджеры, полученные по имени: Справочники[ИмяСправочника]. Это позволяет писать код, работающий с любым объектом метаданных без жёсткой привязки.

Как проверить, что работа идёт с нужным экземпляром

Основные инструменты проверки — ТипЗнч(), сравнение ссылок и отладчик. В отладчике видно, какой именно экземпляр находится в переменной, какие у него значения свойств и совпадает ли ссылка с ожидаемой записью в базе.

Если код работает с несколькими экземплярами одной записи (например, объект получен дважды через ПолучитьОбъект()), при записи второго можно получить ошибку блокировки или перезаписать чужие изменения. Правило простое: одна единица работы — один экземпляр объекта в памяти.

Типичные ошибки при работе с экземплярами

Отдельно стоит помнить про производительность: ПолучитьОбъект() загружает в память все данные записи, включая табличные части. В циклах по тысячам ссылок это заметно замедляет работу. Если нужно только прочитать реквизиты — используйте ссылку или запрос, а объект получайте только тогда, когда планируете изменение и запись.

Сравнение подходов: ссылка, объект, запрос

Выбор зависит от задачи. Нужно прочитать пару реквизитов у одной записи — достаточно ссылки. Нужна выборка по условию — запрос. Нужно изменить запись с контролем прав и вызовом обработчиков событий — только объект.

Частые вопросы