0

Процедура ЗаполнитьЗначенияСвойств()

Копирует свойства одного объекта в одноименные свойства другого

Синтаксис

Процедура ЗаполнитьЗначенияСвойств() имеет следующий синтаксис:

ЗаполнитьЗначенияСвойств(Приемник, Источник, [СписокСвойств], [ИсключаяСвойства])

А также альтернативный англоязычный синтаксис:

FillPropertyValues(Destination, Source, [PropertiesList], [ExclProperties])

Параметры

Описание параметров процедуры ЗаполнитьЗначенияСвойств():

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

Внимание! Значение данного параметра не может быть примитивного типа!

Источник Произвольный Значения свойств данного объекта будут установлены в соответствующие свойства Приемника.

Внимание! Значение данного параметра не может быть примитивного типа!

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

Описание

Процедура ЗаполнитьЗначенияСвойств() Копирует свойства одного объекта в одноименные свойства другого. Сопоставление свойств производится по именам. Если указан параметр СписокСвойств, то в заполнении участвуют только они, параметр ИсключаяСвойства игнорируется. В противном случае, если указан параметр ИсключаяСвойства, свойства перечисленные в нем, исключаются из обработки.

Доступность

Версия Поддержка
8.1 Сервер, Клиент, Внешнее соединение
8.2 Сервер, Толстый клиент, Тонкий клиент, Веб-клиент, Внешнее соединение
8.3 Сервер, Толстый клиент, Тонкий клиент, Веб-клиент, Внешнее соединение, Мобильный автономный сервер, Мобильный клиент, Мобильное приложение

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

Пример кода с использованием процедуры ЗаполнитьЗначенияСвойств():

Источник = Новый Структура("Наименование,Код", "Стул деревянный", 1);
Получатель = Новый Структура("Наименование,Код");
ЗаполнитьЗначенияСвойств(Получатель, Источник);
Сообщить(Получатель.Наименование + " [" + Получатель.Код + "]");
//Стул деревянный [1]

ЗаполнитьЗначенияСвойств(Получатель, Источник, "Наименование");
Сообщить(Получатель.Наименование + " [" + Получатель.Код + "]");
//Стул деревянный []

ЗаполнитьЗначенияСвойств(Получатель, Источник, , "Код");
Сообщить(Получатель.Наименование + " [" + Получатель.Код + "]");
//Стул деревянный []

Поделиться страницей в соц.сетях

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *