Функция 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 генерирует ошибку.