15.13. Управление свойствами таблиц и курсоров

cProperty

Значения eExpression

"AllowSimultaneousFetch"

 .T. – курсоры схожей конфигурации, разделяющие соединение, могут обновлять записи одновременно;  .F. – не могут. Применяется с удаленными видами, разделяемыми соединениями и ODBC-курсорами

"AutoIncError"

 .T. – генерируется ошибка при попытке вставить или обновить значение поля типа Integer (AutoInc);  .F. – ошибка не генерируется; поставляемое значение, однако, не используется, а берется соответствующая величина

"BatchUpdateCount"*

Число обновляющих операторов, посылаемых буферизованным таблицам удаленного источника данных. По умолчанию равно 1. Правильный подбор значения этого свойства может резко увеличить быстродействие в режиме автоматического обновления

"Buffering"

 1 – (по умолчанию для таблиц) отключает буферизацию записи и таблицы;  2 – пессимистическая буферизация записи;  3 – (по умолчанию для видов) оптимистическая буферизация записи;  4 – пессимистическая буферизация таблицы;  5 – оптимистическая буферизация таблицы. SET MULTILOCKS должен быть установлен в ON для всех значений свойства, кроме 1

"CompareMemo"

 .T. – (по умолчанию) memo- и general-поля, а для удаленного вида timestamp-поля включаются в опцию WHERE для обновления;  .F. – не включаются. Применяется при автоматическом обновлении таблиц источника данных

"FetchAsNeeded"

 .T. – данные доставляются, когда это необходимо, например когда выполняется перемещение на запись, данные которой не доставлены;  .F. – дополнительные данные доставляются во время бездействия. Свойство не используется, когда прогрессивная выборка отключена (FetchSize = –1)

"FetchMemo"*

 .T. – (по умолчанию) доставляются memo- и general-поля вида;  .F. – не доставляются

"FetchSize"*

Число записей, доставляемых единовременно удаленной таблице. По умолчанию равно 100. Установка FetchSize = –1 означает получение полного результата, ограниченного величиной MaxRecords Замечание. Единовременная выборка захватывает соединение на все время доставки данных. Это надо учитывать, задавая FetchSize при работе с разделяемым соединением (ShareConnection = .T.)

"KeyFieldList"

Список разделенных запятыми первичных полей курсора. Должен быть задан при автоматическом обновлении таблиц источника данных

"MapBinary"

 .T. – при SQL-передаче данных SQL_BINARY, SQL_VARBINARY и SQL_LONGVARBINARY ODBC-типы данных приводятся к типу данных Varbinary или Blob. Для удаленных видов команда CREATE SQL VIEW тип данных ODBC SQL_LONGVARBINARY обрабатывает как тип данных Blob, а типы данных ODBC SQL_BINARY и SQL_VARBINARY – как Varbinary, если длина поля источника данных не более 254 байт, и как Blob – в противном случае;  .F. – (по умолчанию) при SQL-передаче данных SQL_BINARY и SQL_VARBINARY ODBC-типы данных приводятся к типу данных Character. Для удаленных видов команда CREATE SQL VIEW обрабатывает типы данных ODBC SQL_BINARY и SQL_VARBINARY как Memo. Замечание. Свойство MapBinary доступно как для чтения, так и для записи, когда рабочая область nWorkArea установлена в 0; доступно только для чтения в случае SQL-курсоров и не применяется для таблиц (параметр nWorkArea равен или больше 1)

"MapVarchar"

 .T. – при SQL-передаче данных SQL_WVARCHAR и SQL_VARCHAR ODBC-типы данных приводятся к типу данных Varchar. То же осуществляет и CREATE SQL VIEW для удаленных видов;  .F. – (по умолчанию) при SQL-передаче данных SQL_WVARCHAR и SQL_VARCHAR ODBC-типы данных приводятся к типу данных Character. То же осуществляет и CREATE SQL VIEW для удаленных видов. Для свойства MapVarchar справедливо замечание, сделанное при рассмотрении свойства MapBinary

"MaxRecords"*

Максимальное число записей в возвращаемом результате. По умолчанию –1 – возвращаются все записи. MaxRecords = 0 означает, что вид выполняется, но результаты не доставляются

"ParameterList"

Параметры опции WHERE. Формат списка следующий: ''ParameterName1, 'Type1'; ParameterName2, 'Type2'; ...'', где Type – это символ C, Y, D, T, B, I, L, N, F, Q или V, означающий тип данных параметра (см. табл. 15.2)

"Prepared"

 .T. – SQL-оператор подготовлен для вызовов функции REQUERY( );  .F. – (по умолчанию) не подготовлен. Функция REQUERY( ) используется для повторной выборки данных для SQL-вида. Детали см. в описании функции SQLPREPARE( )

"Refresh"

Задает частоту обновления курсора в текущей сессии данных (устанавливается командой SET DATASESSION). Чтобы задать значение свойства Refresh для всех вновь открытых курсоров, параметр nWorkArea устанавливается в 0. При этом значение свойства Refresh ранее открытых курсоров не изменится. По умолчанию свойство Refresh равно –2 – используется глобальное refresh-значение, заданное параметром nSeconds2 команды SET REFRESH. Замечание. Установка свойства Refresh функцией CURSORSETPROP( ) будет проигнорирована, если параметр nSeconds2 команды SET REFRESH имеет значение 0

"SendUpdates"

 .T. – SQL-обновление посылается таблицам-источникам данных (обновленные в виде данные будут доставлены таблицам-источникам);  .F. – (по умолчанию) не посылается

"Tables"

Список разделенных запятыми имен удаленных обновляемых таблиц. Должен быть задан при автоматическом обновлении таблиц источника данных

"UpdatableFieldList"

Список разделенных запятыми имен полей. Может включать поля как локальных, так и удаленных таблиц. Должен быть задан при автоматическом обновлении таблиц источника данных

"UpdateNameList"

Список разделенных запятыми имен полей удаленных и локальных таблиц, употребляемых в курсоре. Параметр используется для задания VFP-корректных имен полей курсора, когда имена полей в таблице-источнике являются недопустимыми для VFP (например содержат пробелы)

"UpdateType"

Тип обновления:  1 или DB_UPDATE – (по умолчанию) старые данные обновляются новыми;  2 или DB_DELETEINSERT– старые данные удаляются, а новые добавляются. Константы DB_UPDATE и DB_DELETEINSERT могут быть использованы, если имеется ссылка на файл FoxPro.h

"UseMemoSize"*

Размер результата (в байтах), превышение которого приводит к тому, что данные для столбца курсора возвращаются как memo-поле. Может изменяться от 1 до 255. По умолчанию равен 255

"WhereType"

Тип опции WHERE в SQL-обновлении удаленных таблиц. Опция WHERE состоит, если значение свойства WhereType равно:  1 или DB_KEY – из первичных полей (первичные поля задаются свойством KeyFieldList);  2 или DB_KEYANDUPDATABLE – из первичных и обновляемых полей;  3 или DB_KEYANDMODIFIED (по умолчанию) – из первичных и изменяемых полей;  4 или DB_KEYANDTIMESTAMP – из первичных полей и полей, выявляемых в результате сравнения времени их обновления. Константы DB_KEY и пр. доступны, если в приложении имеется ссылка на файл FoxPro.h