sqlprepare( ) 函数

示例 请参阅

在使用 SQLEXEC( ) 执行远程数据操作前，可使用本函数使远程数据为将要执行的命令做好准备。

语法

SQLPREPARE(nConnectionHandle, cSQL命令, [CursorName])

返回值类型

数值型

参数

nConnectionHandle

指定连接句柄 (connection handle) ，这个句柄通常是由 SQLCONNECT( ) 函数返回的。

cSQLLCommand

要传递给远程数据源，并由远程数据源执行的 SQL 语句。

在这个 SQL 语句中的 WHERE 子句中可以包含参数，但所有 WHERE 子句中的参数都必须在 SQLPREPARE( ) 执行前事先定义。例如，如果您在WHERE 子句中包含有一个变量，那么这个变量必须在 SQLPREPARE( ) 执行前已被初始化。

CursorName

指定一个 Visual FoxPro 临时表。SQL 语句执行后返回的查询结果将被保存在这个表中。如果您不指定表名，Visual FoxPro 将用 SQLRESULT 作为默认表明。

如果远程执行后的结果需要多个临时表，临时表名将由您指定的表名结尾加递增的数字编号组成。

说明

SQLPREPARE( ) 将 SQL 语句传送到数据源，在那里，SQL 语句被事先编译。这样，当您执行 SQLEXEC( ) 函数时，速度会快得多。另外，如果您事先执行了SQLPREPARE( )，那么在其后的 SQLEXEC( ) 所使用的参数中只须指定连接句柄nConnectionHandle 即可。