DBVar.SetValue

SetValue (Значение переменной БД)
Объект: Объект базы данных Статус разработки: Реализована Тип: Функция Обращение к БД: Сервер и БД Исключения: Невозможно превратить в строку, дату, неверное наименование Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Объект базы данных

Функция позволяет сохранить значение переменной БД по ее имени. Если переменная является периодической, функция также принимает диапазон дат для сохранения ее значения. Если диапазон не задан, для сохранения периодического значения используется внутренний диапазон сохранения периодических значений (см. UsePeriod). Функция может использоваться совместно с интерфейсом переменной базы данных. Если необходимо сохранить таблицу периодических реквизитов в значение переменной БД, используйте функцию SavePeriodicalValues.

Синтаксис

DB.DBVar.SetValue(Наименование переменной БД (STRING),<Устанавливаемое значение переменной БД>,<Дата начала изменения периодического значения (DATE)>,<Дата окончания изменения периодического значения (DATE)>)

Аргументы

• <Наименование переменной БД (STRING)> - Задает наименование переменной БД, значение которой необходимо установить.
• <Устанавливаемое значение переменной БД> - Устанавливаемое значение переменной. Если тип значения не соответствует типу значения переменной, тип будет приведен (т.е., если переменная имеет тип число, а аргумент имеет строчный тип, строка будет превращена а число до установки значения).
• <Дата начала изменения периодического значения (DATE)> - (необязательный аргумент) Задает дату начала периода сохранения периодического значения переменной. Если переменная не периодическая, этот аргумент игнорируется.
• <Дата окончания изменения периодического значения (DATE)> - (необязательный аргумент) Задает дату окончания периода сохранения периодического значения переменной. Если переменная не периодическая, этот аргумент игнорируется. Если аргумент не задан, однако аргумент Дата начала изменения периодического значения задан и не соответствует пустой дате, этот аргумент устанавливается равным предыдущему (запись производится на дату, а не на диапазон дат), если оба аргумента не заданы, используется диапазон записи, заданный функцией UsePeriod.

Примеры

//Производит установку на сегодняшний день значения периодической переменной БД "ЮрЛицоДляПеремещений". Новое значение содержится в переменной аЮЛ.
DBVar.SetValue("ЮрЛицоДляПеремещений",аЮЛ,Date());