Как добавить элемент в список значений в 1С: все способы с примерами

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

Особое внимание уделим типичным ошибкам, которые приводят к потере данных при модификации списка во время итерации или некорректному отображению элементов в интерфейсе. Вы узнаете, как добавлять элементы не только в конец, но и в произвольную позицию, как работать с иерархическими списками, а также как оптимизировать код для больших массивов данных. Все примеры приведены с комментариями и пояснениями, чтобы даже новички могли легко их адаптировать под свои задачи.

1. Базовый метод: Добавить()

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

Синтаксис метода:

СписокЗначений.Добавить(Значение, Пометка, Картинка, Данные)

Где:

• 🔹 Значение — обязательный параметр, содержимое элемента (строка, число, дата и т.д.)
• 🔹 Пометка — необязательный флаг (истина/ложь), по умолчанию Ложь
• 🔹 Картинка — необязательная пиктограмма для визуального отображения
• 🔹 Данные — необязательный произвольный объект, связанный с элементом

Пример добавления трёх элементов с разными типами данных:

Список = Новый СписокЗначений();
Список.Добавить("Товар 1", Истина);     // Строка с пометкой
Список.Добавить(1000);           // Число без пометки
Список.Добавить(ТекущаяДата(), , Новый Картинка("img1")); // Дата с картинкой

2. Добавление в произвольную позицию: Вставить()

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

Синтаксис:

СписокЗначений.Вставить(Индекс, Значение, Пометка, Картинка, Данные)

Ключевые нюансы:

• 🔸 Если указать Индекс = 0, элемент станет первым в списке
• 🔸 При Индекс = Список.Количество() элемент добавится в конец (аналог Добавить())
• 🔸 Если индекс превышает текущий размер списка, возникнет ошибка {ОбщийМодуль.СписокЗначений.Модуль(13)}: Индекс вне допустимого диапазона

Пример вставки элемента на вторую позицию:

Список = Новый СписокЗначений();
Список.Добавить("Первый элемент");
Список.Добавить("Третий элемент");
Список.Вставить(1, "Второй элемент"); // Теперь порядок: 0, 1 (новый), 2

⚠️ Внимание: При вставке элементов в циклах по этому же списку (например, Для Каждого Элем Из Список Цикл) может произойти бесконечный цикл или пропуск элементов. Всегда используйте обратный порядок или работайте с копией списка.

3. Массовое добавление элементов

Когда нужно добавить сразу несколько элементов, гораздо эффективнее использовать метод ЗагрузитьЗначения() или цикл с Добавить(). Первый вариант работает быстрее для больших массивов (100+ элементов), так как минимизирует количество операций с памятью.

Сравнение производительности:

Пример использования ЗагрузитьЗначения():

МассивДанных = Новый Массив();
МассивДанных.Добавить("Элемент1");
МассивДанных.Добавить("Элемент2");
МассивДанных.Добавить("Элемент3");

Список = Новый СписокЗначений();
Список.ЗагрузитьЗначения(МассивДанных);

Создать массив данных заранее|Проверить типы данных на совместимость|Очистить целевой список при необходимости|Использовать ЗагрузитьЗначения() для 50+ элементов-->

Для иерархических списков (с родительскими элементами) массовая загрузка требует дополнительной обработки. В этом случае лучше использовать цикл с явным указанием родителя через параметр Данные:

Родитель = Список.Добавить("Категория 1");
Список.Добавить("Подкатегория 1.1", , , , Родитель);
Список.Добавить("Подкатегория 1.2", , , , Родитель);

4. Добавление элементов через конструктор

В 1С:Предприятие 8.3 появился удобный визуальный конструктор списка значений, который позволяет добавлять и редактировать элементы без написания кода. Этот способ идеально подходит для быстрого прототипирования или когда нужно показать пользователю диалог выбора.

Как открыть конструктор:

1. Создайте переменную типа СписокЗначений
2. В панели свойств найдите кнопку .. рядом с полем значения
3. В открывшемся окне используйте кнопки Добавить, Вставить и Удалить

Преимущества конструктора:

• 📌 Визуальное управление иерархией элементов
• 📌 Возможность присваивать картинки и пометки через интерфейс
• 📌 Автоматическая проверка типов данных

⚠️ Внимание: Элементы, добавленные через конструктор, сохраняются только на время сеанса. Для постоянного хранения списка его нужно сериализовать в ХранилищеЗначения или записать в базу данных.

5. Работа с иерархическими списками

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

Пример создания трёх уровней вложенности:

Список = Новый СписокЗначений();

// Уровень 1
Родитель1 = Список.Добавить("Категория А");
Родитель2 = Список.Добавить("Категория Б");

// Уровень 2
Подкатегория1 = Список.Добавить("Подкатегория А1", , , , Родитель1);
Подкатегория2 = Список.Добавить("Подкатегория А2", , , , Родитель1);

// Уровень 3
Список.Добавить("Элемент 1", , , , Подкатегория1);
Список.Добавить("Элемент 2", , , , Подкатегория1);

Для проверки принадлежности элемента к родителю используйте метод Родитель():

Если Список.Родитель(Подкатегория1) = Родитель1 Тогда
Сообщить("Элемент принадлежит категории А");
КонецЕсли;

Особенности иерархических списков:

• 🌳 Максимальная глубина вложенности — 100 уровней (ограничение платформы)
• 🌳 При удалении родительского элемента дочерние удаляются автоматически
• 🌳 Для отображения в интерфейсе используйте реквизит формы с типом ДеревоЗначений

6. Добавление элементов с проверкой уникальности

Частая задача — добавлять элементы в список только если их там ещё нет. Для этого можно использовать метод НайтиПоЗначению(), который возвращает Неопределено, если элемент не найден.

Базовый алгоритм:

Значение = "Уникальный элемент";
Если Список.НайтиПоЗначению(Значение) = Неопределено Тогда
Список.Добавить(Значение);
КонецЕсли;

Для сложных объектов (например, структур) или когда нужно учитывать несколько полей, лучше создать собственную функцию сравнения:

Функция ЭлементУжеСуществует(Список, НовыйЭлемент)
Для Каждого Элем Из Список Цикл
Если Элем.Значение.Код = НовыйЭлемент.Код И Элем.Значение.Наименование = НовыйЭлемент.Наименование Тогда
Возврат Истина;
КонецЕсли;
КонецЦикла;
Возврат Ложь;
КонецФункции;

Оптимизация для больших списков (1000+ элементов):

• 🔍 Предварительно отсортируйте список по полю, по которому ищете дубли
• 🔍 Используйте двоичный поиск через НайтиПоЗначению() после сортировки
• 🔍 Для критических участков кода рассмотрите использование Соответствие вместо СписокЗначений

7. Типичные ошибки и их решение

Даже опытные разработчики иногда сталкиваются с неожиданным поведением списков значений. Разберём самые распространённые проблемы и способы их избежать.

Ошибка 1: "Индекс вне допустимого диапазона" при использовании Вставить()

⚠️ Внимание: Эта ошибка возникает, когда вы пытаетесь вставить элемент по индексу, превышающему текущий размер списка. Всегда проверяйте границы:

Индекс = 5;
Если Индекс <= Список.Количество() Тогда
Список.Вставить(Индекс, "Новый элемент");
Иначе
Список.Добавить("Новый элемент"); // Добавляем в конец
КонецЕсли;

Ошибка 2: Изменение списка во время итерации

Если вы модифицируете список в цикле Для Каждого, это может привести к пропуску элементов или зацикливанию. Решение — использовать обратный цикл или работать с копией:

// Плохо (может пропустить элементы):
Для Каждого Элем Из Список Цикл
Если Элем.Значение = "Удалить" Тогда
Список.Удалить(Элем);
КонецЕсли;
КонецЦикла;

// Хорошо (обратный цикл):
Для Инд = Список.Количество() - 1 По 0 Цикл Убыв
Если Список[Инд].Значение = "Удалить" Тогда
Список.Удалить(Инд);
КонецЕсли;
КонецЦикла;

Ошибка 3: Потеря ссылок на элементы после изменения списка

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

Элемент = Список[0]; // Получили ссылку
Список.Вставить(0, "Новый"); // Структура изменилась
// Теперь Элемент указывает на неверную позицию!
Элемент = Список[1]; // Нужно получить заново

FAQ: Частые вопросы по работе со списками значений

Элемент = Список.НайтиПоЗначению("Искомое значение");
Если Элемент <> Неопределено Тогда
Элемент.Пометка = Истина;
Элемент.Картинка = НоваяКартинка;
Иначе
Список.Добавить("Искомое значение", Истина, НоваяКартинка);
КонецЕсли;

СтруктураДанных = Новый Структура("Код, Наименование", 123, "Пример");
Список.Добавить(СтруктураДанных);

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Наименование ИЗ Справочник.Номенклатура";
Результат = Запрос.Выполнить();

Список = Новый СписокЗначений();
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
Список.Добавить(Выборка.Наименование);
КонецЦикла;

ТекстJSON = ПолучитьТекстИзФайла("data.json");
Данные = JSON.Прочитать(ТекстJSON);

Список = Новый СписокЗначений();
Для Каждого Элем Из Данные Цикл
Список.Добавить(Элем.Наименование);
КонецЦикла;