Функция DBSETPROP( )

Устанавливает свойство для текущей базы данных или поля, именованного соединения, таблицы или представления текущей базы данных.

Синтаксис:

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

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 14.12.2002