Функция CURSORSETPROP( )

Задает установки свойств для таблицы или курсора Visual FoxPro.

Синтаксис:

CURSORSETPROP(cProperty [, eExpression] [, cTableAlias | nWorkArea])

Параметры:
cProperty
Задает свойство таблицы или курсора, которое следует установить. Необходимо отметить, что для таблицы Visual FoxPro можно задать только одно свойство Buffering (буферизация).
eExpression
Задает значение для свойства, указанного аргументом cProperty. Если выражение eExpression опущено, значение свойства устанавливается по умолчанию.
В следующем списке перечислены свойства, которые можно указать в аргументе cProperty, и описания значений, которые может принимать eExpression:

cTableAlias
Задает псевдоним таблицы или курсора, для которого устанавливается значение свойства.
nWorkArea
Задает рабочую область таблицы или курсора, для которого устанавливается значение свойства. Если вы задаете 0 для nWorkArea, CURSORSETPROP( ) устанавливает свойства для всех последующих таблиц и курсоров.

Результат:
Логический

Комментарии:
Функция CURSORSETPROP( ) возвращает значение "истина" (.T.), если Visual FoxPro успешно устанавливает заданное свойство. Если указанное свойство установить не удается, Visual FoxPro генерирует ошибку.
Значение свойства Buffering в функции CURSORSETPROP( ) определяет, каким образом Visual FoxPro выполняет блокировку записей и буферизацию обновлений. Подробнее о том, как свойство Buffering влияет на блокировку записей и буферизацию обновлений, см. тему Буферизация доступа к данным и главу 19 "Программирование совместного доступа к данным" Руководства разработчика.
Значение свойства WhereType в функции CURSORSETPROP( ) определяет, как выполняется обновление в удаленных таблицах. Подробнее об обновлении удаленных таблиц см. главу 6 "Применение баз данных" Руководства разработчика.
С помощью функции CURSORSETPROP( ) можно отменить значение свойства FetchSize, установленное для курсора функцией SQLSETPROP( ). Данное свойство по умолчанию наследуется из номера соединения данного курсора.
Пользуйтесь функцией CURSORGETPROP( ) для возвращения текущих установок свойств таблицы Visual FoxPro или курсора, созданного для таблицы.
Если функция CURSORSETPROP( ) выдается без необязательных аргументов cTableAlias или nWorkArea, установка свойства задается для таблицы или курсора, открытых в выбранной в данный момент рабочей области.

Пример:

* В следующем примере показано, как установить мягкую буферизацию с
* помощью CURSORSETPROP( ). Команда SET MULTILOCKS устанавливается
* в ON, это требование буферизации. Открывается таблица customer в базе
* данных testdata, затем вызывается функция CURSORSETPROP( ) для
* установки мягкой буферизации (5). Если такая буферизация возможна,
* результатом будет "истина" (.T.), в противном случае  "ложь" (.F.).

CLOSE DATABASES
SET MULTILOCKS ON
SET PATH TO (HOME( ) + 'samples\data\')  	&& Sets path to database
OPEN DATABASE testdata  && Open testdata database
USE customer	  && Open customer table

CLEAR
? CURSORSETPROP('Buffering', 5, 'customer')  && Sets buffering mode

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