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

DBSETPROP(cName, cType, cProperty, ePropertyValue)

Параметры

cName

Определяет имя текущей открытой базы данных или поля, именованного подключения, таблицы, или представления в текущей открытой базе данных для который DBGETPROP( ) возвращает информацию. Для задания свойства поля в таблице или представлении, добавьте к имени поля имя таблицы или представления, содержащего это поле. Например, чтобы установить свойство для поля 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 должено иметь тот же тип данных, как тип данных свойства.
Предостережение:
Visual FoxPro не проверяет, что значение, которое Вы определяете, допустимо для свойства. Таким образом, имеется возможность установить свойство в недопустимое значение с помощью DBSETPROP( ) . Например, DBSETPROP( ) может быть использована, чтобы установить выражение правила поля в выражение, которое является недопустимым для этого поля, и Visual FoxPro не будет генерировать ошибку. Чтобы избежать ошибки при установке свойства представления таблиц, предварительно проверьте ePropertyValue со знаком обозначения базы данных в следующем синтаксисе:

Скопировать код
         <databaseName>!ePropertyValue

Возвращаемое значение

Логический тип данных. DBSETPROP( ) возвращает Истину (.T). если Visual FoxPro успешно устанавливает свойство, которое Вы определяете. Visual FoxPro генерирует ошибку, если свойство, которое Вы определяете, не может быть установлено.

Замечания

Для подробной информации о поиске текущих значений свойства, см. DBGETPROP( ) Функция .

Пример

Следующий примера использует DBSETPROP( ) для задания комментария для поля cust_id в таблице customer . DBGETPROP( ) используется, чтобы отобразить комментарий.

Скопировать код
CLOSE DATABASES
CLEAR
OPEN DATABASE (HOME(2) + 'data\testdata')
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

См. Также