Как получить количество строк в динамическом списке 1С — 5 способов

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

В отличие от статических таблиц, динамические списки загружают данные порциями (пагинация), что усложняет подсчет общего количества записей. В этой статье мы разберем 5 рабочих способов определения количества строк — от простых встроенных функций до программных обходов с учетом особенностей платформы 1С 8.3 и 8.2. Каждый метод сопровождается примерами кода и пояснениями, когда его целесообразно применять.

1. Стандартный метод: свойство `ВыбранноеКоличество()`

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

Пример использования в обработчике команды:

Процедура КомандаПолучитьКоличество(Команда)
Количество = ЭлементыФормы.ДинамическийСписок1.ВыбранноеКоличество();
Сообщить("Выделено строк: " + Количество);
КонецПроцедуры

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

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

2. Использование метода `ПолучитьДанные()` с пагинацией

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

Пример кода для формы с динамическим списком ДинамическийСписок1:

Процедура ПолучитьОбщееКоличествоСтрок()
ДанныеСписка = ЭлементыФормы.ДинамическийСписок1.ПолучитьДанные();
ОбщееКоличество = ДанныеСписка.ИтогоСтрок;
Сообщить("Всего строк в списке: " + ОбщееКоличество);
КонецПроцедуры

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

3. Программный обход коллекции `Список`

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

Пример для списка, созданного на основе запроса:

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

КоличествоСтрок = РезультатЗапроса.Выгрузить().Количество();
Сообщить("Количество строк в результате запроса: " + КоличествоСтрок);

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

💡

Чтобы избежать расхождений, синхронизируйте отборы в запросе и динамическом списке. Например, передавайте параметры отбора из формы в текст запроса перед выполнением.

4. Альтернативный подход: запрос к источнику данных

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

Пример для справочника Номенклатура:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   COUNT(*) КАК Количество
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура";
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();
Если Выборка.Следующий() Тогда
Сообщить("Общее количество номенклатуры: " + Выборка.Количество);
КонецЕсли;

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

⚠️ Внимание: При использовании этого метода в управляемых формах убедитесь, что запрос выполняется в фоновом задании или с ограничением по времени, чтобы не блокировать интерфейс пользователя.

5. Работа с пагинацией: учет текущей страницы

Динамические списки в 1С часто используют пагинацию — разбиение данных на страницы. Если требуется узнать количество строк на текущей странице, можно воспользоваться свойством КоличествоВидимыхСтрок или методом ПолучитьСтроки().

Пример для управляемой формы:

ТекущиеСтроки = ЭлементыФормы.ДинамическийСписок1.ПолучитьСтроки();
КоличествоНаСтранице = ТекущиеСтроки.Количество();
Сообщить("Строк на текущей странице: " + КоличествоНаСтранице);

Для получения номера текущей страницы и общего количества страниц используйте свойства ТекущаяСтраница и КоличествоСтраниц:

ТекущаяСтраница = ЭлементыФормы.ДинамическийСписок1.ТекущаяСтраница; ОбщееКоличествоСтраниц = ЭлементыФормы.ДинамическийСписок1.КоличествоСтраниц;

Сообщить(СтрШаблон("Страница %1 из %2", ТекущаяСтраница, ОбщееКоличествоСтраниц));

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

Убедитесь, что динамический список настроен на постраничный просмотр|Проверьте значение свойства РазмерСтраницы|Синхронизируйте отборы при смене страницы|Тестируйте на больших объемах данных-->

Сравнение методов: какой выбрать?

Выбор способа получения количества строк зависит от контекста задачи. Ниже представлена сравнительная таблица методов с указанием их особенностей:

Метод	Подходит для	Учитывает отборы	Зависит от пагинации	Производительность
`ВыбранноеКоличество()`	Выделенных строк	Нет	Нет	Мгновенно
`ПолучитьДанные().ИтогоСтрок`	Общего количества	Да	Нет	Быстро
Коллекция `Список`	Программных списков	Частично	Нет	Средняя
Запрос к БД	Точных данных	Да (если указаны)	Нет	Медленно
`ПолучитьСтроки()`	Текущей страницы	Да	Да	Мгновенно

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

💡

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

Типичные ошибки и как их избежать

При работе с динамическими списками разработчики часто сталкиваются с типичными ошибками, которые приводят к некорректному подсчету строк. Рассмотрим наиболее распространенные из них:

🔴 Игнорирование отборов: Если динамический список имеет отборы, примененные пользователем, но запрос к источнику данных их не учитывает, результаты будут расходиться. Всегда синхронизируйте отборы.
🔴 Путаница между видимыми и общим количеством: Методы вроде КоличествоВидимыхСтрок возвращают только отображаемые строки, а не общее количество. Используйте их осознанно.
🔴 Забывают про пагинацию: При программном обходе строк через ПолучитьСтроки() учитывайте, что метод вернет только текущую страницу. Для полного обхода используйте цикл по страницам.
🔴 Блокировка интерфейса длинными запросами: Запросы к большим таблицам могут "подвешивать" форму. Выполняйте их в фоновом задании или с ограничением времени.

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

📌 Отсутствии отборов
📌 Применении сложных отборов (с вложенными условиями)
📌 Разных размерах страницы (например, 10, 50, 100 строк)
📌 Пустом результате (когда отборы не возвращают ни одной строки)

Как обойти все страницы динамического списка?

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

1. Получите общее количество страниц через КоличествоСтраниц.

2. В цикле меняйте ТекущаяСтраница от 1 до КоличествоСтраниц.

3. На каждой итерации получайте строки через ПолучитьСтроки() и обрабатывайте их.

4. Не забудьте вернуть исходную страницу после завершения цикла, чтобы не сбивать пользователя.

Пример кода:

КоличествоСтраниц = ЭлементыФормы.ДинамическийСписок1.КоличествоСтраниц; ТекущаяСтраницаИсходная = ЭлементыФормы.ДинамическийСписок1.ТекущаяСтраница; Для НомерСтраницы = 1 По КоличествоСтраниц Цикл ЭлементыФормы.ДинамическийСписок1.ТекущаяСтраница = НомерСтраницы; Строки = ЭлементыФормы.ДинамическийСписок1.ПолучитьСтроки(); // Обработка строк... КонецЦикла;

ЭлементыФормы.ДинамическийСписок1.ТекущаяСтраница = ТекущаяСтраницаИсходная;

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

Можно ли получить количество строк в динамическом списке без программирования?

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

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

Почему ПолучитьДанные().ИтогоСтрок возвращает 0, хотя строки есть?

Это типичная ситуация, когда:

Динамический список еще не загружен (например, форма только открылась, и данные не подгрузились).
К списку применены отборы, которые исключают все строки.
Список сконфигурирован с ошибками (например, неверно указан источник данных).

Проверьте, что список успешно загружен, и отборы не фильтруют все данные. Также убедитесь, что вы обращаетесь к правильному элементу формы (например, ЭлементыФормы.ДинамическийСписок1, а не к другому объекту).

Как обновить количество строк после изменения отборов?

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

ЭлементыФормы.ДинамическийСписок1.Отбор.Дата.УстановитьЗначение(ТекущаяДата());
ЭлементыФормы.ДинамическийСписок1.Обновить();
Количество = ЭлементыФормы.ДинамическийСписок1.ПолучитьДанные().ИтогоСтрок;

Без вызова Обновить() список может продолжать отображать старое количество строк.

Можно ли получить количество строк в динамическом списке на мобильной платформе 1С?

Да, все описанные методы работают и в мобильном приложении 1С:Предприятие, так как оно использует ту же платформу. Однако учитывайте:

На мобильных устройствах пагинация может быть более агрессивной (меньше строк на странице).
Запросы к базе данных могут выполняться дольше из-за ограничений по производительности.
Интерфейсные методы (например, ПолучитьСтроки()) возвращают только видимые строки, как и в десктопной версии.

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

Как оптимизировать подсчет строк в больших динамических списках (100 000+ строк)?

При работе с большими объемами данных:

📊 Используйте индексированные поля в отборах, чтобы ускорить выполнение запросов.
📊 Заменяйте COUNT(*) на COUNT(ИндексированноеПоле), если это возможно.
📊 Для динамических списков настраивайте серверную пагинацию (загрузку данных порциями с сервера).
📊 Избегайте полного обхода всех строк — если нужно только количество, используйте ПолучитьДанные().ИтогоСтрок вместо программного перебора.
📊 Рассмотрите возможность кэширования количества строк, если оно редко меняется.

Пример оптимизированного запроса для подсчета:

Запрос.Текст = "ВЫБРАТЬ РАЗЛИЧНЫЕ COUNT(Ссылка КАК Количество) ИЗ Справочник.Номенклатура КАК Номенклатура

ГДЕ Номенклатура.ПометкаУдаления = ЛОЖЬ";

Как получить количество строк в динамическом списке 1С: пошаговые инструкции и примеры кода

1. Стандартный метод: свойство ВыбранноеКоличество()

2. Использование метода ПолучитьДанные() с пагинацией

3. Программный обход коллекции Список