Копирует свойства одного объекта в одноименные свойства другого
Синтаксис
Процедура ЗаполнитьЗначенияСвойств()
имеет следующий синтаксис:
ЗаполнитьЗначенияСвойств(Приемник, Источник, [СписокСвойств], [ИсключаяСвойства])
А также альтернативный англоязычный синтаксис:
FillPropertyValues(Destination, Source, [PropertiesList], [ExclProperties])
Параметры
Описание параметров процедуры ЗаполнитьЗначенияСвойств()
:
Имя параметра* | Тип | Описание |
---|---|---|
Приемник | Произвольный | Значение, чьи свойства будут заполнены значениями соответствующих свойств Источника .
Внимание! Значение данного параметра не может быть примитивного типа! |
Источник | Произвольный | Значения свойств данного объекта будут установлены в соответствующие свойства Приемника .
Внимание! Значение данного параметра не может быть примитивного типа! |
СписокСвойств | Строка | Ограничивает список имен свойств которые необходимо заполнить. Имена свойств указываются через запятую. Если параметр опущен, то копируются только те свойства, которые представлены одновременно и в Источнике , и в Приемнике . |
ИсключаяСвойства | Строка | Список имен свойств Приемника, разделенный запятыми, которые необходимо исключить из заполнения. Если свойства, указанного в параметре не окажется в Приемнике , будет вызвано исключение. |
*Жирным шрифтом выделены обязательные параметры |
Описание
Процедура ЗаполнитьЗначенияСвойств()
Копирует свойства одного объекта в одноименные свойства другого. Сопоставление свойств производится по именам. Если указан параметр СписокСвойств
, то в заполнении участвуют только они, параметр ИсключаяСвойства
игнорируется. В противном случае, если указан параметр ИсключаяСвойства
, свойства перечисленные в нем, исключаются из обработки.
Доступность
Версия | Поддержка |
---|---|
8.1 | Сервер, Клиент, Внешнее соединение |
8.2 | Сервер, Толстый клиент, Тонкий клиент, Веб-клиент, Внешнее соединение |
8.3 | Сервер, Толстый клиент, Тонкий клиент, Веб-клиент, Внешнее соединение, Мобильный автономный сервер, Мобильный клиент, Мобильное приложение |
Пример использования
Пример кода с использованием процедуры ЗаполнитьЗначенияСвойств()
:
Источник = Новый Структура("Наименование,Код", "Стул деревянный", 1); Получатель = Новый Структура("Наименование,Код"); ЗаполнитьЗначенияСвойств(Получатель, Источник); Сообщить(Получатель.Наименование + " [" + Получатель.Код + "]"); //Стул деревянный [1] ЗаполнитьЗначенияСвойств(Получатель, Источник, "Наименование"); Сообщить(Получатель.Наименование + " [" + Получатель.Код + "]"); //Стул деревянный [] ЗаполнитьЗначенияСвойств(Получатель, Источник, , "Код"); Сообщить(Получатель.Наименование + " [" + Получатель.Код + "]"); //Стул деревянный []