C U R S O R G E T P R O P 函数

C U R S O R G E T P R O P 函数 - 图3 返回 Visual FoxPro 表或临时表的当前属性设置

语法

CURSORGETPROP ( cProperty [, n WorkArea | cTableAlias ])

返值类型

C U R S O R G E T P R O P 函数 - 图4 字符型数值型或逻辑型

参数描述

cProperty

C U R S O R G E T P R O P 函数 - 图5 指定要返回的属性设置

C U R S O R G E T P R O P 函数 - 图6 下表列出了可以返回的属性设置返回值的数据类型以及返回值说明

cProperty 类型描述

BatchUpdateCount* N 送到缓冲表后端的更新语句的数目 1 是默认

C U R S O R G E T P R O P 函数 - 图8 值调整该值可大大提高更新的性能可读写

C U R S O R G E T P R O P 函数 - 图12 Buffering N 1- 默认值行缓冲和表缓冲关闭

打开保守式行缓冲
打开开放式行缓冲
打开保守式表缓冲
打开开放式表缓冲可读写

CompareMemo L 若用于检测更新冲突的 WHERE 子句中包含备注

C U R S O R G E T P R O P 函数 - 图20 字段或通用字段返回 .T. 默认否则返回 .F. 本属性只用于视图

C U R S O R G E T P R O P 函数 - 图27 可读写

C U R S O R G E T P R O P 函数 - 图28 ConnectHandle N 连接句柄只有在数据源中包含远程表时此属性

C U R S O R G E T P R O P 函数 - 图29 才有效只读

C U R S O R G E T P R O P 函数 - 图31 ConnectName C 在创建临时表时使用的命名连接

C U R S O R G E T P R O P 函数 - 图32 只读

C U R S O R G E T P R O P 函数 - 图33 Database C 包含表或视图的数据库名称如表是自由表包

C U R S O R G E T P R O P 函数 - 图35 含空字符串只读

C U R S O R G E T P R O P 函数 - 图37 FetchAsNeeded L 若只有在需要时才将数据调入返回 .T. 否则返回 .F. 默认

C U R S O R G E T P R O P 函数 - 图43 可读写

C U R S O R G E T P R O P 函数 - 图44 FetchMemo* L 如果视图结果中含有备注字段则为真

C U R S O R G E T P R O P 函数 - 图47 (.T.) 否则为假 (.F.) 默认值可读写

C U R S O R G E T P R O P 函数 - 图54 FetchSize* N 从远程表结果集合中逐步提取的行数默认是

C U R S O R G E T P R O P 函数 - 图55 100 行设置 FetchSize 为 -1 将检索整个结果集但受 MaxRecords 设置限制可读写

C U R S O R G E T P R O P 函数 - 图60 KeyFieldList C 逗号分隔的临时表的主字段列表

C U R S O R G E T P R O P 函数 - 图61 可读写

C U R S O R G E T P R O P 函数 - 图62 MaxRecords* N 当返回结果集时所提取的最大行数默认值是 -1 返回所有行

值指定运行视图
但不提取结果可读写

Prepared	L	如果 SQL 语句已准备好可以执行 REQUERY
		返回 .T. 否则返回 .F. 默认REQUERY 用于从一个 SQL 视图中重新检索数据有关 SQL 语句的准备请参阅SQLPREPARE 本属性只用于视图
SendUpdates	L	可读写如果 SQL 更新查询被执行以更新远程表则为
		真 (.T.) 否则为假 (.F.) 默认值
SourceName	C	可读写包含数据库中的 SQL 视图或表的长名或者自由
		表的文件路径和表名
		可读写
SourceType	N	1- 指定数据源是本地 SQL 视图
		2- 指定数据源是远程 SQL 视图
		3- 指定数据源是表
SQL	C	只读 Th 创建临时表时执行的 SQL 语句
		只读
Tables	C	逗号分隔的远程表名的列表
		可读写

C U R S O R G E T P R O P 函数 - 图69

C U R S O R G E T P R O P 函数 - 图108 UpdatableFieldList C 逗号分隔的指定给临时表的远程字段名和本地字段名的列表

C U R S O R G E T P R O P 函数 - 图109 可用该选项将临时表的无效 Visual FoxPro 字段名指定为有效的 Visual FoxPro 字段名

C U R S O R G E T P R O P 函数 - 图110 可读写

C U R S O R G E T P R O P 函数 - 图111 续表

UpdateNameList	C	逗号分隔的视图中字段的列表该列表包含有来
		自本地和远程表的字段
UpdateType	N	可读写 1- 指定用新数据更新旧数据默认值
		2- 指定通过删除旧数据插入新数据来进行更
		新
		可读写
UseMemoSize*	N	使得结果返回到备注字段的列的最小宽度按字
		节例如如果一个列的结果的宽度比 UseMemoSize 的值大列结果存储在备注字段

C U R S O R G E T P R O P 函数 - 图120 中 UseMemoSize 可以从 1 到 255 默认值是

C U R S O R G E T P R O P 函数 - 图127 255

C U R S O R G E T P R O P 函数 - 图128 可读写

续表

C U R S O R G E T P R O P 函数 - 图129 WhereType N 更新远程表的 WHERE 子句 WhereType 可以指定为下列值

或

DB_KEY 源于 FOXPRO.H 对远程表进行更新的 WHERE 子句仅包含由 KeyFieldList 属性指定的主关键字段
或

DB_KEYANDUPDATABLE 源于

C U R S O R G E T P R O P 函数 - 图136 FOXPRO.H 对远程表进行更新的 WHERE 子句包含由 keyFieldList 属性指定的主关键字段及任何可更新的字段

或
DB_KEYANDMODIFIED 源于

C U R S O R G E T P R O P 函数 - 图140 FOXPRO.H 默认值对远程表进行更新的WHERE 子句包含由 keyFieldList 属性指定的主关键字段及任何已修改字段

或
DB_KEYANDTIMESTAMP 源于

C U R S O R G E T P R O P 函数 - 图146 FOXPRO.H 对远程表进行更新的 WHERE 子句包含由 keyFieldList 属性指定的主关键字段和时间戳

C U R S O R G E T P R O P 函数 - 图149 可读写

* 此属性的返回值只对远程视图才是重要的如果您对本地视图取得此属性

C U R S O R G E T P R O P 函数 - 图150 CURSORGETPROP 函数返回默认值

C U R S O R G E T P R O P 函数 - 图153 下表中包含可以返回设置的属性返回值的数据类型及返回值的说明的列表

cProperty Type 说明

BatchUpdate Count*

N 送到缓冲表后端的更新语句的数目 1 是默认值调整该值可大大提高更新的性能

C U R S O R G E T P R O P 函数 - 图155 可读写

C U R S O R G E T P R O P 函数 - 图159 Buffering N 1- 默认值行缓冲和表缓冲关闭

打开保守式行缓冲
打开开放式行缓冲
打开保守式表缓冲
打开开放式表缓冲可读写

CompareMemo L 若用于检测更新冲突的 WHERE 子句中包

C U R S O R G E T P R O P 函数 - 图169 含备注字段或通用字段返回 .T. 默认否则返回 .F. 本属性只用于视图

C U R S O R G E T P R O P 函数 - 图176 可读写

ConnectHandle ConnectName	N C	连接句柄只有在数据源中包含远程表时此属性才有效只读在创建临时表时使用的命名连接只有在数据
		源中包含远程表时此属性才有效只读

源中包含远程表时此属性才有效

只读

C U R S O R G E T P R O P 函数 - 图181

Database FetchAsNeeded	C L	包含表或视图的数据库名称包含空字符串只读若只有在需要时才将数据调入	如表是自由表返回 .T. 否
		则返回 .F. 默认
		可读写
FetchMemo*	L	如果视图结果中含有备注字段	则为真

则返回 .F. 默认

可读写

FetchMemo*

如果视图结果中含有备注字段

则为真

C U R S O R G E T P R O P 函数 - 图184 (.T.) 否则为假 (.F.) 默认值可读写

C U R S O R G E T P R O P 函数 - 图202 FetchSize* N 从远程表结果集合中逐步提取的行数默认是

C U R S O R G E T P R O P 函数 - 图203 100 行设置 FetchSize 为 -1 将检索整个结果集但受 MaxRecords 设置限制

	可读写
KeyFieldList	C	逗号分隔的临时表的主字段列表
		可读写
MaxRecords*	N	当返回结果集时所提取的最大行数默认值是 - 1 返回所有行

KeyFieldList

逗号分隔的临时表的主字段列表

可读写

MaxRecords*

当返回结果集时所提取的最大行数默认值是 -

1 返回所有行

C U R S O R G E T P R O P 函数 - 图209 0 值指定运行视图但不提取结果可读写

C U R S O R G E T P R O P 函数 - 图217

Prepared	L	如果 SQL 语句已准备好可以执行 REQUERY 返回 .T. 否则返回 .F. 默认REQUERY 用于从一个 SQL 视图中重新检索数据有关 SQL 语句的准备请参阅
		SQLPREPARE 本属性只用于视图
		可读写
SendUpdates	L	如果 SQL 更新查询被执行以更新远程表则为
		真 (.T.) 否则为假 (.F.) 默认值可读写
SourceName	C	包含数据库中的 SQL 视图或表的长名	或者自
		由表的文件路径和表名
		只读
SourceType	N	1- 指定数据源是本地 SQL 视图
		指定数据源是远程 SQL 视图指定数据源是表
SQL	C	只读创建临时表时执行的 SQL 语句
		只读
列表	C	逗号分隔的远程表名的列表
		可读写

Updatable FieldList

C 逗号分隔的指定给临时表的远程字段名和本地字段名的列表

C U R S O R G E T P R O P 函数 - 图255 可用该选项将临时表的无效 Visual FoxPro 字段名指定为有效的 Visual FoxPro 字段名

C U R S O R G E T P R O P 函数 - 图257 可读写

C U R S O R G E T P R O P 函数 - 图258 UpdateNameList C 逗号分隔的视图中字段的列表该列表包含有

C U R S O R G E T P R O P 函数 - 图259 来自本地和远程表的字段可读写

C U R S O R G E T P R O P 函数 - 图261 UpdateType N 1- 指定用新数据更新旧数据默认值

C U R S O R G E T P R O P 函数 - 图264 2- 指定通过删除旧数据插入新数据来进行更新

C U R S O R G E T P R O P 函数 - 图266 可读写

UseMemoSize* N 使得结果返回到备注字段的列的最小宽度 C U R S O R G E T P R O P 函数 - 图267 按

C U R S O R G E T P R O P 函数 - 图268 字节例如如果一个列的结果的宽度比UseMemoSize 的值大列结果存储在备注字段中 UseMemoSize 可以从 1 到 255 默认值是255

C U R S O R G E T P R O P 函数 - 图275 可读写

C U R S O R G E T P R O P 函数 - 图276 WhereType N 更新远程表的 WHERE 子句 WhereType 可以

C U R S O R G E T P R O P 函数 - 图277 指定为下列值

或

DB_KEY 源于 FOXPRO.H 对远程表进行更新的 WHERE 子句仅包含由KeyFieldList 属性指定的主关键字段
或

DB_KEYANDUPDATABLE 源于

C U R S O R G E T P R O P 函数 - 图283 FOXPRO.H 对远程表进行更新的 WHERE 子句包含由 keyFieldList 属性指定的主关键字段及任何可更新的字段

或
DB_KEYANDMODIFIED 源于

C U R S O R G E T P R O P 函数 - 图287 FOXPRO.H 默认值对远程表进行更新的 WHERE 子句包含由 keyFieldList 属性指定的主关键字段及任何已修改字段

或
DB_KEYANDTIMESTAMP 源于

C U R S O R G E T P R O P 函数 - 图293 FOXPRO.H 对远程表进行更新的 WHERE 子句包含由 keyFieldList 属性指定的主关键字段和时间戳

C U R S O R G E T P R O P 函数 - 图296 可读写

C U R S O R G E T P R O P 函数 - 图297 * 此属性的返回值只对远程视图才是重要的如果您对本地视图取得此属性

C U R S O R G E T P R O P 函数 - 图299 CURSORGETPROP 函数返回默认值

n W o rkArea

C U R S O R G E T P R O P 函数 - 图300 从返回的属性设置可以指定表的工作区域如果指定工作区域为 0 CURSORGETPROP 函数返回环境设置

cTableAlias

C U R S O R G E T P R O P 函数 - 图305 从返回的属性设置可以指定工作表的别名

说明

C U R S O R G E T P R O P 函数 - 图306 可用 CURSORSETPROP 设置 Visual FoxPro 表或临时表的具体属性有关每个属性及它们的设置请参阅 CURSORSETPROP

C U R S O R G E T P R O P 函数 - 图313 如果发出不带可选 cTableAlias 或 nWorkArea 参数的 CURSORGETPROP 命令则在当前选定工作区中打开的表或临时表的当前属性设置被返回

示例

C U R S O R G E T P R O P 函数 - 图317 下面示例打开了数据库中的表然后用 CURSORGETPROP

C U R S O R G E T P R O P 函数 - 图320 来显示表的缓冲方式以及包含该表的数据库名称

CLOSE DATABASES CLEAR

OPEN DATABASE (HOME(2) + 'data\testdata') USE customer && 打开客户表

C U R S O R G E T P R O P 函数 - 图323 ? "Buffering" && 返回缓冲模式

? "Database" && 返回数据库的名字

请参阅

C U R S O R G E T P R O P 函数 - 图331 CURSORSETPROP , SQLGETPROP , SQLSETPROP

C U R S O R G E T P R O P 函 数

C U R S O R G E T P R O P 函 数

C U R S O R G E T P R O P 函数

C U R S O R G E T P R O P 函数