把当前数据库中的命名连接名、关系名、表名或 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 将产生错误信息。