ASSIGN

Изменяет одно поле текущей записи датасета.

Синтаксис

ASSIGN (Датасет и поле, Значение)

Аргументы

Датасет и поле

строка, которая состоит из имени одного из датасетов электронной или печатной формы и имени поля этого датасета, разделенных точкой.
Можно указать через ";" сразу несколько полей данного датасета: датасет.поле1;поле2;поле3;...

Особыe режимы:

• Если перед именем датасета указан символ "*", то поле изменяется во всех записях датасета. В этом случае второй аргумент - всегда выражение, потому записывается в кавычках.
• Если вместо имени поля указан символ "*", то изменятся все данные датасета. В этом случае значением должны быть данные другого датасета, либо 1/0 (тогда датасет будет закрыт).
• Имя поля может иметь вид Heap.XXX, в этом случае модифицируется одна строка поля Heap
• Префикс EMBEDDED:Имя_контейнера: означает, что датасет нужно искать в форме, внедренной в указанный контейнер
• Префикс EMBEDDING: означает, что датасет нужно искать в форме, в которую внедрена текущая форма
• Префикс LAUNCHFORM: означает, что датасет нужно искать в форме, с которой запущена текущая форма
  

Значение

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

Тип результата

Нет

Примеры

Assign( `Goodies.Price`, 1 ) – изменит текущую запись
Assign( `Dataset.Document;Articul;Certificate;BarCode`, :Id, :Art, :Cert, :BC ) – изменит сразу несколько полей
Assign( `*Goodies.Price`, `Price*2` ) – изменит все записи (удвоит цену)
Assign( `*dsGds.Qty;New`, `1,0` ) – инициализация двух полей во всех записях датасета (в данном случае значения полей - это выражение, поэтому записываются в кавычках)
Assign( `*dsLines.Name;Note`, `'Имя','Комментарий'` ) – то же самое с текстовыми значениями
Assign( `DataSet.Heap.xxx`, 1 ) – изменит хиповое поле
Assign( `launchform:HeapSet.@FullName`, HeapSet.FullName ) – изменит поле родительской формы