Устанавливает свойство для текущей базы данных или поля, именованного соединения, таблицы или представления текущей базы данных.
Синтаксис:
DBSETPROP(cName, cType, cProperty, ePropertyValue)
Параметры:
cName
Задает имя базы данных, поля, именованного соединения, таблицы или представления, для которого следует установить свойство.
Чтобы установить свойство для поля в таблице или представлении, перед именем поля нужно поставить имя содержащей его таблицы или представления. Например, чтобы установить свойство для поля custid в таблице customer, задайте в качестве cName следующее:
customer.custid
cType
Указывает, что представляет собой cName текущую базу данных или поле, именованное соединение, таблицу или представление в текущей базе данных. В следующей таблице перечислены значения, которые можно задавать в качестве cType.
cType Описание CONNECTION cName именованное соединение в текущей базе данных. DATABASE cName текущая база данных. FIELD cName поле в текущей базе данных. TABLE cName таблица в текущей базе данных. VIEW cName представление в текущей базе данных.
cProperty
Задает имя устанавливаемого свойства. Если допустимо только чтение, значение свойства нельзя изменить функцией DBSETPROP( ). При попытке установить такое свойство, Visual FoxPro выдаст сообщение об ошибке.
Подробнее о свойствах, которые можно задать в аргументе cProperty, включая их типы данных, см. DBGETPROP( ).
ePropertyValue
Задает значение, устанавливаемое для свойства cProperty. Значение ePropertyValue должно иметь тот же тип данных, что и само свойство.
Внимание! С помощью функции DBSETPROP( ) вы можете установить недопустимое значение свойства. Visual FoxPro не проверяет допустимость устанавливаемого значения для данного свойства. Например, с помощью функции DBSETPROP( ) можно установить выражение правила поля таким образом, что оно будет недопустимо для поля, но Visual FoxPro не сгенерирует ошибку.
Результат:
Логический.
Комментарии:
Пользуйтесь функцией DBSETPROP( ), чтобы устанавливать свойства для текущей базы данных или для полей, именованных соединений, таблиц или представлений в текущей базе данных. Текущие значения свойств можно определить с помощью функции DBGETPROP( ).
Для функции DBSETPROP( ) требуется эксклюзивное использование текущей базы данных. Чтобы открыть базу данных в эксклюзивном режиме, включите предложение EXCLUSIVE в команду OPEN DATABASE.
DBSETPROP( ) возвращает значение "истина" (.T.), если Visual FoxPro успешно устанавливает заданное свойство. Если свойство установить нельзя, Visual FoxPro генерирует ошибку.
Пример:
* В следующем примере функция DBSETPROP( ) задает комментарий для * поля cust_id из таблицы customer. Функция DBGETPROP( ) используется * для вывода этого комментария на экран. CLOSE DATABASES SET PATH TO (SYS(2004) + 'samples\data\') && Sets path to database OPEN DATABASE testdata && Open testdata database USE customer && Open customer table = DBSETPROP('customer.cust_id', 'Field', 'Comment', ; 'Property has been set by DBSETPROP.') && New field comments cRESULTS = DBGETPROP('customer.cust_id', 'Field', 'Comment') WAIT WINDOW 'Cust_id field comments: '+ cRESULTS && Display comments