Functions.SqlTables 方法 | |
将数据源中的表名存储到 X# 游标中。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 FUNCTION SqlTables(
nStatementHandle AS LONG,
cTableTypes AS STRING,
cCursorName AS STRING
) AS LONG
public static int SqlTables(
int nStatementHandle,
[DefaultParameterValueAttribute("", 0)] string cTableTypes,
[DefaultParameterValueAttribute("SQLRESULT", 0)] string cCursorName
)
查看代码参数
- nStatementHandle
- 类型:Int32
指定由 SqlConnect( ) 返回的数据源的语句句柄。
- cTableTypes
- 类型:String
指定一个或多个表类型。有效的表类型包括 'Table,' 'View,' 'System Table',或任何有效的数据源特定的表类型标识符。 如果您包含一个表类型列表,用逗号分隔各个表类型。
如果省略 cTableTypes 或 cTableTypes 为空字符串,将选择数据源中的所有表名。
您指定的表类型必须用单引号括起来。以下示例演示了如何将 'View' 和 'System Table' 表类型指定为字符串字面量。
1? SqlTables(handle, "'View', 'System Table'", "mydbresult")
- cCursorName
- 类型:String
指定结果集发送到的 X# 游标的名称。如果不包含游标名称,X# 使用默认名称 SQLRESULT。
结果的结构取决于 ODBC 句柄的内部 SqlTables( ) 函数。
返回值
类型:
Int32
数值型。
如果成功创建游标,SqlTables( ) 返回 1;
如果 SqlTables( ) 仍在执行,返回 0;
如果发生连接级别错误,返回 -1;
如果发生环境级别错误,返回 -2。
备注
SqlTables( ) 是四个可以同步或异步执行的函数之一。
SqlSetProp( ) 的异步设置决定这些函数是同步还是异步执行。
在异步模式下,您必须重复调用 SqlTables( ) 直到它返回一个非 0 的值(仍在执行)。
示例 1STORE SqlConnect('MyFoxSQLNT', '<userid>', '<password>') TO gnConnHandle
2
3IF gnConnHandle < 0
4 = MessageBox('无法建立连接', 16, 'SQL 连接错误')
5ELSE
6 = MessageBox('连接已建立', 48, 'SQL 连接消息')
7 STORE SqlTables(gnConnHandle, 'Table', 'mycursor') TO nTables
8
9 IF nTables = 1
10 Select mycursor
11 LIST
12 ENDIF
13ENDIF
参见