Admin: 1 revision imported

2021-02-07T06:43:21Z

1 revision imported

Admin at 07:56, 10 September 2019

2019-09-10T07:56:45Z

New page

{{infobox function
|name=<Наименование реквизита>
|object=[[Объект базы данных]]
|caption=Работа с реквизитами объекта БД
|type=0
|status=2
|db=2
|exception=Не выбран вид объекта, не загружен пер. реквизит
|rw=3
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект базы данных]]}}
Атрибут получает или изменяет значение реквизита по наименованию. '''Важно''': если объект не выбран (позиционирован), функция возвратит пустое значение, соответствующее типу данных указанного реквизита (это поведение уменьшает необходимое количество проверок, при каскадном вызове реквизитов, к примеру, конструкция <code>Номенклатура.ТоварнаяГруппа.Префикс</code>, вызывала бы исключение в момент обращения к реквизиту ''Префикс'', если бы реквизит ТоварнаяГруппа не был заполнен и вызов атрибута ''Номенклатура.ТоварнаяГруппа'' возвращал бы пустое значение, в текущей же реализации, он возвратит пустое значение типа справочник вида ''ТоварныеГруппы'', что позволит произвести последующее обращение к его реквизиту, который в свою очередь также вернется пустым с нужным типом данных). '''Важно''': При обращении к периодическим реквизитам объекта с помощью имени реквизита, функция возвратит значение реквизита только в случае, когда он был предварительно загружен (т.е. опция ''PeriodicalProperties'' в [[DB.UseOption|UseOption]] перед загрузкой объекта была установлена в 1), если реквизит не был загружен, функция не производит его загрузку, а инициирует исключение (это помогает исключить ошибки, трактующие периодические реквизиты, как обычные), для получения значения периодического реквизита можно использовать функцию [[DB.GetValue|GetValue]]. Если объект был загружен, функция не вызывает обращения к серверу базы данных (не затрачивает значительное время на загрузку из БД). При изменении (установке) значения реквизита, изменения не записываются в базу данных до момента вызова функции [[DB.Save|Save]], объект получает признак ''измененный'', если производится визуальное редактирование объекта, форма редактирования также получает признак ''были изменения''. При изменении реквизитов объектов, отображенных на формах, изменения автоматически транслируются на элементы формы. При чтении или записи реквизитов, функция производит заполнение объекта БД из базы данных в следующих случаях:
* Объект был выбран, но не заполнен, либо заполнен в режиме только заголовка
* Объект был заполнен в режиме частичного заполнения, однако запрашиваемый реквизит не входит в число загруженных реквизитов.

== Синтаксис ==
<code>
{{Grey|DB.}}'''<Наименование реквизита>''':''<Значение реквизита>''
</code>

==== Возвращаемое значение ====
Возвращается значение указанного реквизита.

== Примеры ==
<pre>
//aEl содержит выбранный и загруженный элемент справочника вида Номенклатура с реквизитом "Code" равным "000000005745"
aEl:=Ref.Номенклатура;
aEl.Find("Code","000000005745");
//Фрагмент выводит значение реквизита ТоварнаяГруппа загруженного элемента
Message("Товарная группа: "+aEl.ТоварнаяГруппа);
//Фрагмент изменяет значение реквизитов Цена и Объем и сохраняет изменения в базе данных
aEl.Цена:=0;
aEl.Объем:=0.1;
aEl.Save();
//Внимание: пример используется только для демонстрации работы с атрибутом имени реквизита, не безопасен для реальной базы данных (не блокируется объект)
</pre>

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)

DB.PropertyName - Revision history

Admin: 1 revision imported

Admin at 07:56, 10 September 2019