Данные строки 1С — метод таблицы формы

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

ДанныеСтроки = Элементы.ТаблицаФормы.ДанныеСтроки(ИдентификаторСтроки);

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

• Является клиентским, его нельзя использовать на сервере. Структуру данных, полученную в результате его использования также нельзя передать на сервер;
• Содержит данные реквизитов добавленных на форму, а также данные реквизитов с установленным флагом Использовать всегда. Остальные реквизиты отсутствуют в коллекции;
• Возвращает данные аналогичные свойству ТекущиеДанные таблицы формы. Разница лишь в том, что при помощи метода ДанныеСтроки можно получить структуру данных любой строки таблицы, а не только текущей;
• Идентификатор строки, передаваемый в параметре может быть разных типов, в зависимости от источника таблицы формы. Для источников ТаблицаЗначений, ДеревоЗначений, СписокЗначений, ТабличнаяЧасть идентификатор строки числовой. Для ДинамическогоСписка это обычно Ссылка, которая является ключом строки списка. Идентификатор текущей строки содержится в свойстве таблицы формы ТекущаяСтрока.

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

ТекущаяСтрока = Элементы.ТаблицаТоваров.ТекущаяСтрока;
ТекущиеДанные = Элементы.ТаблицаТоваров.ДанныеСтроки(ТекущаяСтрока);

ТекущиеДанные = Элементы.ТаблицаТоваров.ТекущиеДанные;

Получение идентификаторов строк

Так как параметром метода ДанныеСтроки является идентификатор, важно знать откуда его можно получить:

• Для текущей строки таблицы формы идентификатор хранится в свойстве ТекущаяСтрока;

  ТекущаяСтрока = Элементы.ТаблицаТоваров.ТекущаяСтрока;

• Идентификаторы выделенных строк таблицы формы можно получить при помощи свойства ВыделенныеСтроки. В нем содержится массив идентификаторов.

  ВыделенныеСтроки = Элементы.ТаблицаТоваров.ВыделенныеСтроки;

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

  Для Каждого СтрокаИсточника Из ТаблицаТоваров Цикл
      Идентификатор = СтрокаИсточника.ПолучитьИдентификатор();
  КонецЦикла;
  

Данные строки 1С — пример использования

Рассмотрим пример получения данных выделенных строк таблицы формы при нажатии кнопки.

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