Другое · 7 мин
Как получить количество строк в динамическом списке 1С
Как узнать число строк в динамическом списке 1С: свойства формы, методы таблицы значений, проверка результата и типичные ошибки при подсчёте.
Динамический список в 1С используется для отображения набора данных, полученного из запроса, таблицы значений или другого источника. Число строк часто нужно для проверки заполнения, построения циклов, управления доступом к кнопкам или принятия решения о продолжении обработки.
Способ получения количества зависит от того, где находится список: на форме в виде элемента управления или в коде как таблица значений / результат запроса. Один и тот же визуальный список может представлять разные объекты, поэтому выбор неправильного свойства или метода чаще всего приводит к нулю или ошибке.
Перед подсчётом важно убедиться, что данные уже загружены и пользователь имеет права на их чтение. Полученное число отражает текущее состояние списка, а не обязательно общее количество записей в базе, если применены фильтры, отбор или постраничная загрузка.
Где находится список и какой объект считать
В управляемой форме динамический список обычно представлен элементом формы типа «Динамический список». У такого элемента есть свойства для получения общего числа строк, текущей строки и выделенных строк. Если список выводится в обычной форме, набор свойств может отличаться, но общая логика сохраняется.
Если в коде у вас не элемент формы, а значение типа ТаблицаЗначений или РезультатЗапроса, тогда не нужно искать свойство элемента. Для таблицы значений применяется метод Количества, для результата запроса — соответствующий метод получения количества записей после выполнения запроса.
Свойство количества строк у элемента формы
Управляемая форма
В управляемой форме обращайтесь к элементу через коллекцию Элементы формы и читайте свойство, соответствующее числу строк динамического списка. Обычно это свойство доступно только для чтения и обновляется после загрузки данных в список.
Примерное действие: получите ссылку на элемент, проверьте, что он существует, затем считайте свойство количества строк. Если список пуст или не загружен, значение может быть равно нулю, что само по себе не является ошибкой.
Обычная форма
В обычных формах элемент динамического списка может предоставлять другие свойства и методы в зависимости от версии платформы и типа конфигурации. Проверяйте доступные свойства через синтакс-помощник или отладчик, не предполагая одинаковых имён для управляемых и обычных форм.
Если количество строк нужно для включения или отключения команды, делайте проверку после загрузки формы и после применения отбора. Свойство может измениться при переоткрытии списка или смене параметров запроса.
Проверьте свойство количества строк у элемента управления после загрузки
Используйте метод Количества у самой таблицы, а не у формы
Убедитесь, что запрос выполнен, и считайте количество записей в результате
Метод Количества у таблицы значений и результата запроса
Для таблицы значений вызывайте метод Количества без параметров. Он возвращает число строк текущей таблицы. Это подходит, когда динамический список построен на основе таблицы значений и вы работаете с ней в коде напрямую.
Для результата запроса сначала выполните запрос, затем получите количество записей из результата. Если запрос не выполнен или вернул пустой набор, число строк будет нулевым. Не путайте количество колонок и количество строк: для подсчёта записей используется именно строковый счётчик.
Если источник данных — запрос с параметрами, убедитесь, что все параметры заданы перед выполнением. Иначе результат может быть пустым или содержать меньше строк, чем ожидалось, и количество будет занижено.
- 1Определите, где находится список: на форме или в коде
- 2Убедитесь, что данные загружены и отбор применён
- 3Выберите подходящее свойство или метод в зависимости от объекта
- 4Считайте количество строк и проверьте результат на ноль или ожидаемое значение
Условия корректного подсчёта и постраничная загрузка
Динамический список может отображать не все записи сразу, а только текущую страницу. В таких случаях свойство количества строк может возвращать число видимых или загруженных строк, а не общее число записей, удовлетворяющих условиям.
Если важно общее количество записей в базе, выполните отдельный запрос с агрегацией или используйте метод получения полного количества, если он предоставляется источником данных. Не полагайтесь только на количество строк в уже отрисованном списке.
Также учитывайте права доступа, роли и ограничения безопасности. Пользователь может видеть меньше строк, чем существует в таблице, и подсчёт по его списку покажет доступную часть, а не полный набор.
Количество = Элементы.МояДинамическаяСписок.КоличествоСтрок;Частые ошибки и проверка результата
Одна из типичных ошибок — попытка прочитать количество строк до загрузки списка. В этот момент список может быть пустым, и проверка даст ложный отрицательный результат. Выполняйте подсчёт после события открытия формы или после завершения загрузки данных.
Другая ошибка — использование свойства элемента формы для таблицы значений или наоборот. Если объект не поддерживает нужное свойство, возникнет ошибка выполнения. Проверяйте тип переменной перед обращением к свойству.
Проверяйте результат в контексте задачи: ноль может означать пустой список, отсутствие прав или невыполненный запрос. Если ноль недопустим, добавьте явную проверку и сообщение пользователю перед дальнейшей обработкой.
Когда не стоит считать строки самостоятельно
Если задача сводится к проверке наличия хотя бы одной записи, не обязательно считать все строки. Можно использовать проверку на пустоту или получение первой строки, что работает быстрее и надёжнее при больших объёмах данных.
Не изменяйте список в процессе подсчёта строк: добавление, удаление или пересортировка могут изменить количество и привести к неконсистентным данным. Для критичных расчётов работайте со снимком данных или завершите изменение перед подсчётом.
Если список используется только для отображения и не влияет на логику, подсчёт может быть избыточным. Оценивайте, действительно ли число строк нужно для принятия решения, чтобы не усложнять код без необходимости.
Итог перед проверкой
Определите объект, из которого берётся список, убедитесь в загрузке данных и примените подходящее свойство или метод. Сравните полученное значение с ожидаемым и учитывайте ограничения прав и постраничной загрузки.
Что важно запомнить
Для элемента формы используйте свойство количества строк, для таблицы значений и результата запроса — метод Количества, а перед проверкой убедитесь в загрузке данных и отсутствии ограничивающего отбора.
Что делать, если количество строк равно нулю?
Проверьте, загружен ли список, применён ли отбор, есть ли у пользователя права на данные и выполнен ли запрос. Ноль может означать пустой результат, а не ошибку программы.
В чем разница между элементом формы и таблицей значений?
Элемент формы отображает данные на интерфейсе и имеет свои свойства, а таблица значений — это объект данных в коде с методом Количества. Использование свойства формы у таблицы значений приведёт к ошибке.
Как посчитать только выделенные строки?
Используйте коллекцию выделенных строк элемента динамического списка и получите её количество. Это отличается от общего числа строк в списке.
Можно ли считать строки во время изменения списка?
Не рекомендуется. Изменения данных во время подсчёта могут сделать результат неточным. Завершите добавление, удаление или сортировку перед подсчётом или работайте с копией данных.