adbobjects( ) 函数

示例 请参阅

把当前数据库中的命名连接名、关系名、表名或 SQL 视图名放到一个内存变量数组中。

语法

ADBOBJECTS(ArrayName, cSetting)

参数
ArrayName

指定存放数据库名称的数组名。若指定数组不存在,Visual FoxPro 将自动创建一个数组。如果数组存在,但数组大小不足以包含所有名称,则 Visual FoxPro 自动增大数组,使得数组能容纳所有名称。如果数组的大小超过所需值,Visual FoxPro 将截掉多余部分;如果数组存在,但由于没找到任何名称导致 adbobjects( ) 函数返回零,则数组内容将保持不变;如果数组不存在,并且 ADBOBJECTS( ) 
函数返回零,则不创建指定数组。
如果一维数组在创建时指定为 CONNECTION、TABLE 或 VIEW,则一维数组中每行包含数据库中的连接名、表名或视图名。

如果创建二维数组时指定为 RELATION,则二维数组的每行对应数据库中的一个关系。数组第一列存放子表名,第二列存放父表名,第三列存放子表的索引标识名,第四列存放父表的索引标识名。
数组的第五列存放参照完整性信息。如果关系没有参照完整性规则,则这一列为空。如果关系具有参照完整性规则,则这一列存放一些字符,这些字符决定了修改、删除和插入的参照完整性规则类型。第一个字符代表更新规则类型,第二个字符代表删除规则类型,第三个字符代表插入规则类型。更新和删除的可选字符值为“C”、“R”和“I”,其中“C”表示级联,“R”表示约束,“I”表示忽略。插入的可选字符值为“R”和“I”,其中“R”表示约束,“I”代表忽略。例如,如果某个关系的参照完整性规则是级联更新、约束删除和忽略插入,则第五列存放符串“CRI”。

cSetting

指定哪些名称放在内存变量数组中。下表列出了参数 cSetting 的可选值和放在数组中的相应名称。

cSetting 名称
CONNECTION 连接名
RELATION 表关系
TABLE 表名
VIEW 视图名


CONNECTION、RELATION、TABLE 和 VIEW 设置不能缩写。

返回值类型

数值型

说明

运行 adbobjects( ) 函数时,必须有一个数据库是打开的,并且为当前数据库,否则 Visual FoxPro 将产生错误信息。