sqltables( ) 函数

示例 请参阅

把数据源中的表名存储到 Visual FoxPro 临时表中。

语法

SQLTABLES(nConnectionHandle [, cTableTypes] [, cCursorName])

参数
nConnectionHandle

由 SQLCONNECT( ) 返回的、指向数据源的连接句柄。

cTableTypes

指定一个或多个表类型。有效的表类型有:“TABLE”、“
VIEW”、“SYSTEM TABLE”或任何有效的数据源特定表类型标识。cTableTypes 必须大写。如果要包含多个表类型列表,请用逗号分隔。
如果省略 cTableTypes 参数,或者 cTableTypes 是空字符串,则选定数据源中所有表名。
指定的表类型必须用单引号括起来。下面的示例演示了如何指定“VIEW”和“SYSTEM TABLE”表类型。

? SQLTABLES(handle, "'VIEW', 'SYSTEM TABLE'", "mydbresult")


cCursorName

指定 Visual FoxPro 临时表的名称,结果集合发送到该临时表。如果不包含临时表名,Visual FoxPro 将使用默认名“
SQLRESULT”。
下表显示临时表中的列:

列名 说明
TABLE_QUALIFIER 表限定符标识
TABLE_OWNER 表拥有者标识
TABLE_NAME 数据字典中的表名。
TABLE_TYPE 数据字典中的表类型
REMARKS 表的说明

返回值类型

数值型

说明

如果成功创建临时表,SQLTABLES( ) 返回 1;如果仍在执行中,则返回 0。如果发生连接级的错误,返回 -1;发生环境级的错误,返回 -2。
SQLTABLES( ) 是既可以同步执行又可以异步执行的四个函数之一。SQLSETPROP( ) 的异步选项设置决定这些函数是同步执行还是异步执行。异步方式下,必须重复调用 SQLTABLES( )
,直到返回一个非“假”(.F.)值,“假”(.F.)值表示函数仍在执行。