CURSORGETPROP(cProperty [, nWorkArea | cTableAlias])

Параметры

cProperty

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

cProperty	Тип	Описание
ADOBookmark	Variant	Содержит значение, которое соответствует Закладке ADO для текущей записи в основанном на ADO курсоре.
ADOCodePage	N	Возвращает кодовую страницу, связанную с основанным на ADO курсоре как определено Свойством ADOCodePage . Только для чтения.
ADORecordset	O	Содержит объектную ссылку к набору записей ActiveX Объекта Данных (ADO), ассоциированным с курсором. Не допустимо для курсоров, которые не основаны на наборе записей ADO. Только для чтения.
AllowSimultaneousFetch	L	Применяется при использовании отдаленных представлений, разделяемых подключений, и к курсорам, созданным с помощью ODBC. AllowSimultaneousFetch содержит Истину (.T). когда подобно конфигурированные курсоры, совместно использующие подключение, получают разрешение выбирать строки одновременно. Иначе, AllowSimultaneousFetch содержит Ложь (.F)., когда одновременная выборка строк не разрешается.
AutoIncError	L	Содержит Истину (.T). когда попытки вставить или обновить значение поля, которое использует значения с автоматическим инкрементным увеличением, генерируют сообщение об ошибке. Содержит Ложь (.F). когда попытки вставить или обновить значение поля, которое использует значения с автоматическим инкрементным увеличением, не генерируют сообщение об ошибках и указанное значение, которое должно быть вставлено или модифицировано игнорируется. Относится к курсорам и сессиям. Чтение - запись.
BatchUpdateCount*	N	Содержит количество инструкций модификации, посланных отдаленному источнику данных для буферизированных таблиц. Значение по умолчанию - 1. Корректировка этого значения может значительно увеличить скорость выполнения модификации. Чтение - запись.
Буферизация	N	1 - Строковая и табличная буферизация выключены. (Значение по умолчанию) 2 - Пессимистическая буферизация строки включена. 3 - Оптимистическая буферизация строки включена. 4 - Пессимистическая буферизация таблицы включена. 5 - Оптимистическая буферизация таблицы включена Чтение - запись.
CompareMemo	L	Содержит Истину (.T). если предложение WHERE для модификаций включает поля типа Мемо, General, или Picture. (Значение по умолчанию). Иначе, содержит Ложь (.F).. Только для представлений. Чтение - запись.
ConnectHandle	N	Дескриптор подключения. Это свойство допустимо только, когда источник данных содержит отдаленную таблицу. Дескриптор подключения, полученный для представления, может закрыться, когда представление закрывается. Только для чтения.
ConnectName	C	Имя подключения, используемое при создании курсора. Это свойство допустимо только, когда источник данных содержит отдаленную таблицу. Только для чтения.
Database	C	Имя базы данных, которая содержит таблицу или представление. Если таблица - свободная таблица, Database содержит пустую строку. Только для чтения.
FetchAsNeeded	L	Если равно Истине (.T)., данные выбираются только при необходимости, так что указатель записи перемещается в строку, которая ещё не была выбрана. Если равно Лжи (.F)., дополнительные данные выбираются в течение времени простоя. (Значение по умолчанию) Обратите внимание: FetchAsNeeded не применяется, когда прогрессивная выборка запрещена (FetchSize - -1). Чтение - запись.
FetchIsComplete	L	Если Истина (.T)., процесс выборки закончен для ODBC или ADO-based курсоров. Если Ложь (.F)., процесс выборки не был закончен. Эта опция не поддерживается для таблиц и локальных представлений или на уровне среды окружения (рабочая область 0).
FetchMemo*	L	Содержит Истину (.T). если memo-поля выбираются в результаты представления. Иначе, содержит Ложь (.F).. (Значение по умолчанию). Используйте Функцию ISMEMOFETCHED () чтобы определить, было ли выбрано memo-поле. Чтение - запись.
FetchSize*	N	Содержит количество строк, выбранных одновременно из отдаленных таблиц. Значение по умолчанию - 100 строк. Установка FetchSize к -1 возвращает полную выборку результатов, ограниченную установкой MaxRecords. Обратите внимание: Прогрессивная выборка удерживает подключение, пока все строки не найдены. Проявите осмотрительность программируя с помощью FetchSize, если ShareConnection равно Истине (.T).. Чтение - запись.
KeyFieldList	C	Разграниченный запятыми перечень первичных полей курсора. Чтение - запись.
MapBinary	L	Содержит Истину (.T). если отключено преобразование Varbinary . Иначе, содержит (.F).. Чтение - запись только для nWorkArea установленной в 0. Только для чтения для SQL Pass-Through курсоров. Недопустимо для курсоров таблицы ( nWorkArea равняется или больше чем 1).
MapVarchar	L	Содержит Истину (.T). если включено преобразование Varchar . Иначе, содержит Ложь (.F).. Чтение - запись только для nWorkArea равной 0. Только для чтения для SQL Pass-Through курсоров. Недопустимо для курсоров таблицы ( nWorkArea равняется или больше чем 1).
MaxRecords*	N	Максимальное количество выбранных строк, когда возвращается выборка результата. Значение по умолчанию - - 1 (все строки возвращены). Значение 0 определяет, что представление выполнено, но выборка результатов отсутствует. Чтение - запись.
ParameterList	C	Разграниченный точкой с запятой, перечень параметров представления и типов параметров. Только для представлений. Чтение - запись.
Prepared	L	Содержит Истину (.T). если инструкции SQL готовы к последующему запросу функции REQUERY( ). Иначе, содержит Ложь (.F.). (Значение по умолчанию). REQUERY( ) используется, чтобы отыскать данные для SQL представления повторно. См. SQLPREPARE( ) для дополнительной информации о подготовке инструкций SQL. Только для представлений. Чтение - запись.
RecordsFetched	N	Содержит числовое значение, которое указывает количество записей, выбранных из источника данных для ODBC или ADO-based курсоров. Это числовое значение может не отразить текущее количество записей для курсора, если записи были локально удалены или добавлены. Эта опция не поддерживается для таблиц и локальных представлений или на уровне среды окружения (рабочая область 0). Обратите внимание: Любые условия фильтра игнорируются при подсчете количества записей. Только для чтения.
Refresh	N	Содержит числовое значение, которое указывает установку обновления для индивидуального курсора в текущем сеансе данных или начальное значение обновления для недавно открытого курсора в текущем сеансе данных.
SendUpdates	L	Содержит Истину (.T). если посылается SQL запрос на модификацию, чтобы обновить таблицы, когда модификация происходит через представление; иначе, содержит ложь (.F). (значение по умолчанию). Чтение - запись.
SourceName	C	Содержит длинное имя для SQL представления или таблицы в базе данных, или путь к файлу и имя таблицы для свободной таблицы. Только для чтения.
SourceType	N	1 - источником данных является локальное SQL представление. 101 (1 + 100) - Курсор создан методом CursorFill . 201 (1 + 200) - Курсор присоединен к объекту CursorAdapter , используя метод CursorAttach . 2 - источником данных является отдаленое SQL представление. 102 (2 + 100) - Курсор создан методом CursorFill . 202 (2 + 200) - Курсор присоединен к объекту CursorAdapter , используя метод CursorAttach . 3 - источник данных - таблица. 103 (3 + 100) - Курсор создан CursorFill . 203 (3 + 200) - Курсор присоединен к объекту CursorAdapter через использование CursorAttach . 4 - курсор основан на наборе записей ADO и присоединен к объекту CursorAdapter . 104 (4 + 100) - Курсор создан CursorFill . 204 (4 + 200) - Курсор присоединен к объекту CursorAdapter через использование CursorAttach . Только для чтения.
SQL	C	Выполнялась инструкция SQL при создании курсора. Только для чтения.
Tables	C	Разграниченный запятыми перечень имен таблиц. Чтение - запись.
UpdatableFieldList	C	Разграниченный запятыми перечень полей в представлении. Этот список может включать поля из локальных и отдаленных таблиц. Чтение - запись.
UpdateNameList	C	Разграниченный запятыми список отдаленных имен полей и локальных имен полей, присвоенных курсору. Используйте эту опцию, чтобы определить допустимые имена Visual FoxPro для полей в курсоре, если они имеют недопустимые имена полей Visual FoxPro. Чтение - запись.
UpdateType	N	1 - Определяет, что старые данные модифицированы новыми данными. (Значение по умолчанию). 2 - Определяет, что модификации происходят, путем удаления старых данные и вставкой новых данных. Чтение - запись.
UseMemoSize*	N	Минимальный размер в байтах столбцов результата для возвращения в memo-полях. Например, если ширина столбца результата больше чем значение UseMemoSize, столбец результата сохраняется в memo-поле. UseMemoSize может изменяться от 1 до 255; значение по умолчанию - 255. Чтение - запись.
WhereType	N	WHERE - предложение для модификаций таблиц. WhereType может определить следующие значения: 1 или DB_KEY (из FOXPRO.H). Предложение WHERE, используемое, чтобы обновить таблицы состоит только из первичных полей, указанных в свойтве KeyFieldList. 2 или DB_KEYANDUPDATABLE (из FOXPRO.H). Предложение WHERE, используемое, чтобы обновить таблицы состоит из первичных полей, указанных в свойствее KeyFieldList и любых ообновляемых полей. 3 или DB_KEYANDMODIFIED (из FOXPRO.H) (значение по умолчанию). Предложение WHERE, используемое, чтобы обновить таблицы состоит из первичных полей, указанных в свойтве KeyFieldList и любых других модифицирууемых полей. 4 или DB_KEYANDTIMESTAMP (из FOXPRO.H). Предложение WHERE, используемое, чтобы обновить таблицы состоящие из первичных полей, указанных в свойтстве KeyFieldList и сравнения временных меток. Чтение - запись.

* Значение, возвращенное этим свойством имеет значение только для отдаленных представлений; если Вы получаете это свойство для локальных представлений, функция CURSORGETPROP () возвращает значение по умолчанию. Следующая таблица включает список свойств, параметры настройки которых могут быть возвращены, тип данных возвращаемого значения, и описания возвращаемого значения.

nWorkArea

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

cTableAlias

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

Символьный, Числовой, или Логический тип данных

Текущие параметры настройки свойства возвращаются для таблицы или курсора, открытого в в настоящее время в выбранной рабочей области если CURSORGETPROP( ) применятеся без дополнительных параметров cTableAlias или nWorkArea . Если Вы используете CURSORGETPROP( ) без выбранной таблицы, открытого курсора, или указанного псевдонима, Вы получаете Ошибку 52 (Нет открытых таблиц в текущей рабочей области.), если рабочая область не определена как в этом примере, CURSORSETPROP("Refresh",-2,0).

Когда курсор открыт, значение по умолчанию для свойства AutoIncError считывается из значения по умолчанию для сессии, которое является текущей заданной по умолчанию установкой сессии. Следующий пример показывает, как Вы можете отыскать заданное по умолчанию значение AutoIncError для каждой сессии, определяя 0 (заданный по умолчанию сеанс) в качествве последнего параметра:

	Скопировать код
CURSORGETPROP("AutoIncError", 0)

Заданная по умолчанию сессия используется при открытии новой частной сессии данных или курсора. Следующий пример показывает, как Вы можете отыскать для курсора или таблицы установку AutoIncError для каждой таблицы, используя параметры nWorkArea или cTableAlias в качестве последнего параметра:

	Скопировать код
CURSORGETPROP("AutoIncError", nWorkArea | cTableAlias)

Следующий пример открывает таблицу "Customer" в базе данных Testdata и использует CURSORGETPROP( ) для отображения режима буферизации таблицы и имя базы данных, в которой содержится таблица:

	Скопировать код
CLOSE DATABASES CLEAR OPEN DATABASE (HOME(2) + 'data\testdata') USE customer && Open customer table ? CURSORGETPROP("Buffering") && Displays buffering mode ? CURSORGETPROP("Database") && Displays database name

Ссылки

Другие Ресурсы