В приведенной ниже таблице перечислены свойства курсора Visual FoxPro, который поддерживает работу с представлениями и подключенными наборами данных, сгруппированные в соответствии с категориями задачи.

Свойства курсора Visual FoxPro
Задача Свойство Назначение

Определение курсора представления.

SQL

Содержит предложение SQL, по которому строится курсор.

Управление взаимодействием между Visual FoxPro и ODBC.

ConnectHandle

Обслуживает удаленные соединения, которые используются курсором.

 

ConnectName

Имя соединения, используемого курсором.

 

Prepare

Определяет будет ли запрос для представления подготолвен до его исполнения.

 

FetchAsNeeded

Определяет будут ли извлекаться строки во время незанятого цикла или только на основе "по необходимости".

 

CompareMemo

Определяет будут ли поля Memo и General участвовать в опции WHERE предложения UPDATE, независимо от установки свойства UpdateType

 

FetchMemo

Определяет будут ли поля Memo и General автоматически извлекаться с набором данных, или будут извлекаться позднее по запросу, при открытии таких полей для просмотра.

 

UseMemoSize

Определяет минимальный размер колонки (от 1 до 255) в наборе данных, когда для такой колонки возвращается поле типа Memo.

 

FetchSize

Определяет число строк, которые извлекаются за один раз из набора удаленных данных.

 

MaxRecords

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

Update data

SendUpdates*

Определяет будут ли обновления в курсоре посылаться таблицам, на которых он основан.

 

BatchUpdateCount

Определяет число предложений обновления посылаемых удаленному источнику данных (back end) для буфферированных таблиц.

 

Tables*

Разделенный запятыми список имен таблиц источника данных; используется для определения областей свойств UpdateNameList и UpdatableFieldsList.

 

KeyFieldList*

Разделенный запятыми список полей Visual FoxPro, которые представляют первичные ключи набора данных, используемых для обновления.

 

UpdateNameList*

Разделенный запятыми список пар полей Visual FoxPro в курсоре с именами таблиц и именами колонок полей, которым вы желаете послать обновление.

 

UpdatableFieldList*

Разделенный запятыми список полей Visual FoxPro для которых посылаются обновления.

 

Buffering

Определяет тип буфферирования производимого на курсоре.

 

UpdateType

Определяет должно ли производиться обновление при использовании команд UPDATE или DELETE и последующей команды INSERT.

 

WhereType

Определяет что должно быть включено в опцию WHERE для обновления табличных данных.

* Свойства, которые должны быть установлены до того, как вы сможете обновить данные.

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

Использование закладки Remote Data в диалоговом окне Options

Некоторые свойства курсора наследуют свои начальные значения из окружения; другие свойства становятся доступными только на уровне курсора. Некоторые свойства доступны для курсоров, представляющих удаленные представления и ODBC или подключенные таблицы SQL pass-through.

Вы можете управлятьн некоторыми установками свойств курсоров и соединений через закладку Remote Data диалогового кона Options. Когда вы выведете закладку Remote Data на передний план, значения в диалоговом окне представляют установки курсора для текущей сессии и глобальные установки для соединений, используемые Visual FoxPro по умолчанию. Когда вы измените значения на закладке Remote Data с последующим щелчком на OK, новые значения сохраняются в текущей сессии курсора и переписывают глобальные установки для соединения. Если вы выберите Set As Default, то установленные вами значения записываются в конфигурируемые системные установки на вашей машине. Приведенная ниже диаграмма иллюстрирует эти взаимодействия.

Вид и установка глобальных и сессионных установок в диалоговом окне Options

FoxProVenusGlobalSessionSettings graphic

Надписи на рисунке сверху вниз и слева направо:
Диалоговое окно Options - открыта закладка Remote Data - Удаленные данные
Командные кнопки: Set As Default - Установить по умолчанию и ОК
 
Регистр операционной системы
Конфигурируемые системные установки на базе "на клиента"
Глобальные установки Visual FoxPro
Текущие установки сессии
Установки сессии (1) Встроенные установки Visual FoxPro
Начальные значение по умолчанию при старте
Начальные установки по умолчанию для всех сессий, за исключение сессии(1)

Установка свойств с SQL Pass-Through

Когда вы создаете курсор, то курсор наследует установки свойств, такие как UpdateType и UseMemoSize, из курсора окружения или курсора 0 текущей сессии. Вы можете изменить эти установки по умолчанию с помощью функции CURSORSETPROP() с указанием 0 в качестве номера курсора.

После того, как вы создадите курсор с SQL pass-through, вы можете изменить активные установки свойств курсора с помощью функции CURSORSETPROP() для курсора представления. Изменение, которые вы произведете в помощью CURSORSETPROP( ) являются временными: временные установки для активного курсора исчезнут, когда вы закроете представление, а для курсора 0 временные установки уйдут при закрытии сессии Visual FoxPro.

Соединения наследуют свойства в схожей манере. Свойства по умолчанию для соединения 0 наследуются при создании и хранении именованного соединения в базе данных. Вы можете изменить эти установки свойств по умолчанию для соединения 0 с помощью функции SQLSETPROP( ). После того, как соединение будет создано и сохранено в базе данных, вы можете изменить его свойства с помощью функции DBSETPROP(). При использовании соединения, установки свойств, хранимые для соединения в базе данных будут унаследованы активным соединением. Вы можете изменить эти свойства активного соединения с помощью функции SQLSETPROP() используя дескриптор соединения.

Как курсоры SQL pass-through представлений, так и именованные соединения могут использовать именнованный источник данных ODBC. Если вы используете источник данных ODBC в курсоре представления SQL pass-through, соединение наследует свойства из значений по умолчанию сессии.

Приведенная ниже диаграмма иллюстрирует наследование свойств для курсоров и соединений, созданных с SQL pass-through. Серые линии представляют поток наследования свойств; черные линии представляют команды Visual FoxPro.

SQL pass-through (SPT) connection and cursor property inheritance

FoxProSQLPassThrough graphic

Надписи на рисунке - слева-направо и сверху вниз:
Текущие установки Visual FoxPro | ODBC
Глобальные установки\Установки текущей сессии | Имена инсталлированных источников данных ODBC
Значения по умолчанию соединения 0 | Значения по умолчанию курсора 0
Создание соединения | Выбор имени источника данных в CREATE CONNECTION или SQLConnect()
(1) База данных\Определение соединения | Легенда: наследование свойств / команды
(2) SQLConnect()
Соединение и курсор SQL pass-through/
Активное соединение -- SQLExec()--> (3) Активный курсор SPT

(1) Если активное соединение основано на источнике данных ODBC его свойства наследуются из соединения 0
(2) Если активное соединение основано на соединении, определенном в базе данных, его свойства наследуются из этого определения.
(3) Свойства активного курсора SPT наследуются из значений по умолчанию курсора 0

Смотрите также