Как удалить все строки из таблицы значений в 1С

Таблица значений — один из самых используемых объектов встроенного языка 1С: в ней хранят промежуточные результаты запросов, данные для обмена, строки для дальнейшей обработки. Задача полностью очистить такую таблицу возникает постоянно: перед повторным заполнением, при сбросе отбора, при переиспользовании объекта в цикле. Правильный способ зависит от того, где находится таблица — в переменной, в реквизите формы или в табличной части объекта.

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

Метод Очистить() — основной способ удаления всех строк

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

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Номенклатура");
ТЗ.Колонки.Добавить("Количество");

// ... заполнение таблицы ...

ТЗ.Очистить(); // все строки удалены, колонки остались

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

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

ТЗ.Очистить();
Сообщить("Строк после очистки: " + ТЗ.Количество()); // 0

Удаление строк в цикле: когда это нужно и когда вредно

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

Выборочное удаление с конца таблицы

Если удалять строки в прямом цикле по индексу, нумерация сдвигается и часть строк пропускается. Правильный приём — идти с конца:

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

Удаление через индекс

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

Очистка табличной части документа или справочника

Табличная часть объекта (например, Товары у документа) — не таблица значений, но интерфейс очистки у неё такой же. Метод Очистить() доступен и здесь:

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

Ключевой момент: изменения в табличной части сохраняются в базе только после записи объекта. Если вызвать Очистить() и не вызвать Записать(), данные в информационной базе останутся нетронутыми.

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

Очистка таблицы значений в реквизите формы

Когда таблица значений объявлена как реквизит управляемой формы, обращение к ней идёт через ЭтаФорма.ИмяРеквизита или просто по имени реквизита. Метод Очистить() доступен и в этом случае:

&НаКлиенте
Процедура ОчиститьТаблицу(Команда)
ТоварыТаблица.Очистить();
КонецПроцедуры

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

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

Очистка дерева значений и связанных таблиц

Дерево значений очищается тем же методом Очистить(), вызванным у корневой коллекции строк: Дерево.Строки.Очистить(). При этом удаляются все ветви вместе с вложенными уровнями.

Если нужно очистить только подчинённые строки конкретной ветви, вызовите Очистить() у коллекции строк этой ветви: СтрокаДерева.Строки.Очистить(). Сама ветвь при этом останется.

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

Проверка результата и производительность

Убедиться, что таблица пуста, можно двумя способами: проверкой ТЗ.Количество() = 0 или просто выводом количества в журнал. Для табличных частей объектов действует то же правило.

По производительности Очистить() существенно быстрее любого цикла: платформа освобождает всю коллекцию строк за одну операцию. На таблицах с десятками тысяч строк разница с циклом Удалить() становится заметной на глаз.

Если после очистки таблица сразу заполняется заново, дополнительных действий не требуется. Если же таблица больше не нужна вовсе, можно присвоить переменной Неопределено, чтобы освободить память, — но только когда структура колонок больше не понадобится.

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