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

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

В этой статье мы разберём 5 различных способов получения текущей строки в динамическом списке, включая их преимущества и недостатки. Вы узнаете, как избежать типичных ошибок, какие методы лучше использовать в зависимости от задачи, и как оптимизировать код для работы с большими объёмами данных. Материал будет полезен как начинающим программистам 1С, так и опытным специалистам, которые хотят систематизировать свои знания.

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

1. Что такое динамический список в 1С и почему важно правильно работать с текущей строкой

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

Текущая строка — это та строка, на которой в данный момент находится курсор пользователя. Правильная работа с ней позволяет:

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

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

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

2. Способ 1: Использование свойства ТекущиеДанные

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

Пример кода для получения данных текущей строки:

&НаКлиенте
Процедура ПолучитьТекущуюСтроку(Команда)
ТекущаяСтрока = ЭлементыФормы.ДинамическийСписок1.ТекущиеДанные;
Если ТекущаяСтрока = Неопределено Тогда
Сообщить("Нет выделенной строки!");
Возврат;
КонецЕсли;

// Работаем с данными
Сообщить("Текущий документ: " + ТекущаяСтрока.Ссылка);
Сообщить("Дата: " + ТекущаяСтрока.Дата);
КонецПроцедуры

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

🔹 Простота использования — не требует дополнительных функций;
🔹 Быстрый доступ к данным без запросов;
🔹 Поддерживается во всех версиях платформы 1С:Предприятие 8.3.

Недостатки:

🔸 Не работает, если строка не выбрана (возвращает Неопределено);
🔸 Не позволяет получить служебные данные (например, пометку удаления).

💡

Если вам нужно гарантированно получить данные даже при отсутствии выделенной строки, используйте событие ПриАктивизацииСтроки динамического списка. Оно срабатывает при выборе любой строки, включая программный выбор.

3. Способ 2: Метод ПолучитьЭлемент()

Метод ПолучитьЭлемент() позволяет получить объект строки по её индексу или ссылке. Это более гибкий способ, так как вы можете работать не только с текущей, но и с любой другой строкой списка. Особенно полезно, если нужно обработать несколько строк или выполнить проверки перед получением данных.

Пример использования:

&НаКлиенте Процедура ОбработатьТекущуюСтроку(Команда) ТекущаяСтрока = ЭлементыФормы.ДинамическийСписок1.ТекущаяСтрока; Если ТекущаяСтрока = Неопределено Тогда Сообщить("Строка не выбрана!"); Возврат; КонецЕсли; // Получаем объект строки ОбъектСтроки = ЭлементыФормы.ДинамическийСписок1.ПолучитьЭлемент(ТекущаяСтрока); // Теперь можно работать с объектом Сообщить("Номер документа: " + ОбъектСтроки.Номер);

КонецПроцедуры

Когда использовать этот метод:

Сценарий	Преимущество
Нужно получить данные по индексу	Можно передать номер строки напрямую
Работа с несколькими строками	Удобно в циклах обработки
Проверка существования строки	Возвращает `Неопределено`, если строка не существует
Доступ к служебным свойствам	Можно получить пометку удаления, статус и др.

⚠️ Внимание: Метод ПолучитьЭлемент() может вернуть Неопределено, если строка была удалена или ещё не загружена в динамический список. Всегда проверяйте результат перед использованием!

4. Способ 3: Работа с выделенными строками

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

Пример кода для получения первой выделенной строки (аналог текущей):

&НаКлиенте
Процедура ОбработатьВыделенныеСтроки(Команда)
ВыделенныеСтроки = ЭлементыФормы.ДинамическийСписок1.ВыделенныеСтроки;
Если ВыделенныеСтроки.Количество() = 0 Тогда
Сообщить("Нет выделенных строк!");
Возврат;
КонецЕсли;

// Берём первую строку как "текущую"
ТекущаяСтрока = ВыделенныеСтроки[0];
ДанныеСтроки = ТекущаяСтрока.Данные;

Сообщить("Выбран документ: " + ДанныеСтроки.Ссылка);
КонецПроцедуры

Особенности метода:

🔹 Работает даже при множественном выделении;
🔹 Позволяет обрабатывать несколько строк одновременно;
🔹 Можно использовать для пакетных операций (например, печать нескольких документов).

Ограничения:

🔸 Требует включённого свойства МножественныйВыбор;
🔸 Если ни одна строка не выделена, коллекция будет пустой;
🔸 Не подходит для списков с отключённым выделением.

Убедиться, что свойство МножественныйВыбор включено|

Проверить количество выделенных строк (ВыделенныеСтроки.Количество())|

Обработать случай, когда строки не выделены|

Использовать первую строку как текущую, если нужно|

Оптимизировать код для работы с большими выборками-->

5. Способ 4: Прямой доступ к коллекции динамического списка

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

Пример получения текущей строки через коллекцию:

&НаКлиенте
Процедура ПолучитьСтрокуЧерезКоллекцию(Команда)
ТекущаяСтрока = ЭлементыФормы.ДинамическийСписок1.ТекущаяСтрока;
Если ТекущаяСтрока = Неопределено Тогда
Сообщить("Строка не выбрана!");
Возврат;
КонецЕсли;

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

Если ИндексСтроки = Неопределено Тогда
Сообщить("Строка не найдена в коллекции!");
Возврат;
КонецЕсли;

ДанныеСтроки = Коллекция[ИндексСтроки];
Сообщить("Найден документ: " + ДанныеСтроки.Ссылка);
КонецПроцедуры

Когда стоит использовать этот метод:

🔹 Нужно выполнить сложные манипуляции с данными (например, сортировка, фильтрация);
🔹 Требуется доступ к служебным свойствам строк;
🔹 Необходимо работать с данными, которые не отображаются в таблице.

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

Что будет, если изменить данные в коллекции без сохранения?

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

6. Способ 5: Использование событий динамического списка

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

Пример обработчика события:

&НаКлиенте Процедура ДинамическийСписок1ПриАктивизацииСтроки(Элемент, Строка, СтандартнаяОбработка) Если Строка = Неопределено Тогда Возврат; КонецЕсли; // Получаем данные текущей строки ТекущиеДанные = Строка.Данные; Сообщить("Активирована строка: " + ТекущиеДанные.Ссылка); // Здесь можно обновлять другие элементы формы ЭлементыФормы.ИнформацияОСтроке.Значение = ТекущиеДанные.Комментарий;

КонецПроцедуры

Преимущества подхода:

🔹 Автоматическое обновление при изменении строки;
🔹 Нет необходимости вручную отслеживать текущую строку;
🔹 Подходит для сложных интерфейсов с зависимыми элементами.

События, которые можно использовать:

🔹 ПриАктивизацииСтроки — при выборе строки;
🔹 ПриИзмененииВыделения — при изменении выделения;
🔹 ПередАктивизациейСтроки — для предварительной проверки.

💡

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

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

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

Ошибка 1: Попытка получить данные из невыделенной строки

Если пользователь не выбрал строку, свойство ТекущиеДанные вернёт Неопределено. Всегда проверяйте наличие строки перед работой:

Если ЭлементыФормы.ДинамическийСписок1.ТекущаяСтрока = Неопределено Тогда
Сообщить("Выберите строку!");
Возврат;
КонецЕсли;

Ошибка 2: Работа с данными без учёта асинхронной загрузки

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

&НаКлиенте Процедура ДинамическийСписок1ПриЗагрузкеДанных(Элемент, ПараметрыЗагрузки) Если ПараметрыЗагрузки.Завершена Тогда Сообщить("Данные загружены, можно работать со строками"); КонецЕсли;

КонецПроцедуры

Ошибка 3: Изменение данных без сохранения

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

&НаСервере
Процедура СохранитьИзменения(ДанныеСтроки)
ДокументОбъект = ДанныеСтроки.Ссылка.ПолучитьОбъект();
ДокументОбъект.Записать();
КонецПроцедуры

Ошибка 4: Неучтённые права доступа

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

Если Не ПравоДоступа("Чтение", Метаданные.Документы.ЗаказПокупателя) Тогда
Сообщить("Нет прав на просмотр данных!");
Возврат;
КонецЕсли;

8. Оптимизация работы с текущей строкой в больших списках

При работе с динамическими списками, содержащими тысячи строк, важно оптимизировать код, чтобы избежать зависаний интерфейса. Вот несколько рекомендаций:

1. Используйте серверные процедуры для тяжёлых операций

Если вам нужно обработать данные текущей строки (например, рассчитать сумму или проверить условия), выносите логику на сервер:

&НаКлиенте Процедура ОбработатьДанные(Команда) Данные = ЭлементыФормы.ДинамическийСписок1.ТекущиеДанные; Результат = ОбработатьДанныеНаСервере(Данные); Сообщить(Результат); КонецПроцедуры &НаСервере Функция ОбработатьДанныеНаСервере(Данные) // Тяжёлые вычисления здесь Возврат "Результат обработки: " + Данные.Сумма * 1.2;

КонецФункции

2. Ограничивайте количество загружаемых данных

Настройте динамический список так, чтобы он загружал только необходимые данные. Используйте свойства ПакетнаяЗагрузка и Автозагрузка:

ЭлементыФормы.ДинамическийСписок1.ПакетнаяЗагрузка = Истина;

ЭлементыФормы.ДинамическийСписок1.Автозагрузка = Ложь;

3. Кэшируйте часто используемые данные

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

Перем ТекущиеДанныеКэш; &НаКлиенте Процедура ПолучитьДанные(Команда) Если ТекущиеДанныеКэш = Неопределено Тогда ТекущиеДанныеКэш = ЭлементыФормы.ДинамическийСписок1.ТекущиеДанные; КонецЕсли; Сообщить(ТекущиеДанныеКэш.Наименование);

КонецПроцедуры

4. Используйте отложенную загрузку для сложных форм

Если форма содержит много элементов, зависящих от текущей строки, загружайте их данные асинхронно:

&НаКлиенте Процедура ДинамическийСписок1ПриАктивизацииСтроки(Элемент, Строка, СтандартнаяОбработка) ЗапуститьАсинхронно("ОбновитьДанныеФормы", Строка.Данные); КонецПроцедуры &НаКлиенте Процедура ОбновитьДанныеФормы(Данные) Экспорт ЭлементыФормы.Информация.Значение = Данные.Комментарий;

КонецПроцедуры

⚠️ Внимание: При работе с очень большими списками (более 10 000 строк) рассмотрите возможность использования виртуальных таблиц или отчётов вместо динамических списков. Они оптимизированы для обработки больших объёмов данных.

Часто задаваемые вопросы (FAQ)

Как получить текущую строку в динамическом списке, если она не выделена?

Если строка не выделена, свойство ТекущиеДанные вернёт Неопределено. В этом случае можно:

Использовать событие ПриАктивизацииСтроки, чтобы отслеживать выбор;
Программно выделить первую строку с помощью метода ВыделитьСтроки();
Показать пользователю сообщение о необходимости выбрать строку.

Пример программного выделения первой строки:

Если ЭлементыФормы.ДинамическийСписок1.ТекущаяСтрока = Неопределено Тогда
Коллекция = ЭлементыФормы.ДинамическийСписок1.Коллекция;
Если Коллекция.Количество() > 0 Тогда
ЭлементыФормы.ДинамическийСписок1.ТекущаяСтрока = Коллекция[0];
КонецЕсли;
КонецЕсли;

Можно ли получить текущую строку на сервере?

Нет, динамический список — это клиентский объект, и его свойства (включая ТекущиеДанные) доступны только на клиенте. Однако вы можете передать данные строки на сервер в качестве параметра:

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

КонецПроцедуры

Почему при получении текущей строки возникает ошибка "Объект не найден"?

Эта ошибка обычно возникает в следующих случаях:

Строка была удалена другим пользователем или транзакцией;
Данные ещё не загружены (асинхронная загрузка не завершена);
Нет прав на чтение данных;
Объект, связанный со строкой, помечен на удаление.

Чтобы избежать ошибки, всегда проверяйте существование строки:

Если ЭлементыФормы.ДинамическийСписок1.ТекущаяСтрока = Неопределено Тогда
Сообщить("Строка не существует!");
Возврат;
КонецЕсли;

Как обновить данные текущей строки после изменения?

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

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

КонецПроцедуры

Если изменения были сделаны на сервере, используйте ОбновитьСписок():

ЭлементыФормы.ДинамическийСписок1.ОбновитьСписок();

Можно ли получить служебные данные текущей строки (например, пометку удаления)?

Да, для этого нужно использовать метод ПолучитьЭлемент(), который возвращает объект строки со всеми служебными свойствами:

ОбъектСтроки = ЭлементыФормы.ДинамическийСписок1.ПолучитьЭлемент(ТекущаяСтрока); Если ОбъектСтроки.ПометкаУдаления Тогда Сообщить("Строка помечена на удаление!");

КонецЕсли;

Служебные свойства, которые можно получить:

🔹 ПометкаУдаления;
🔹 Статус (например, проведён/не проведён);
🔹 ЭтоГруппа (для иерархических списков).

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

1. Что такое динамический список в 1С и почему важно правильно работать с текущей строкой

2. Способ 1: Использование свойства ТекущиеДанные

3. Способ 2: Метод ПолучитьЭлемент()

4. Способ 3: Работа с выделенными строками

5. Способ 4: Прямой доступ к коллекции динамического списка

6. Способ 5: Использование событий динамического списка

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

8. Оптимизация работы с текущей строкой в больших списках

Часто задаваемые вопросы (FAQ)

📖 Читайте также