Functions.SqlPrepare 方法 | |
准备一个 SQL 语句以便通过 SqlExec( ) 远程执行。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 [NeedsAccessToLocalsAttribute(TRUE)]
FUNCTION SqlPrepare(
nStatementHandle AS LONG,
cSQLCommand AS STRING,
cCursorName AS STRING
) AS LONG
[NeedsAccessToLocalsAttribute(true)]
public static int SqlPrepare(
int nStatementHandle,
string cSQLCommand,
[DefaultParameterValueAttribute("SQLRESULT", 0)] string cCursorName
)
查看代码参数
- nStatementHandle
- 类型:Int32
指定由 SqlConnect( ) 返回的数据源的语句句柄。
- cSQLCommand
- 类型:String
指定传递到数据源的 SQL 语句。
SQL 语句可以包含参数化的 Where 子句,这会创建一个参数化视图。在发出 SqlPrepare( ) 之前,必须定义 Where 子句中的所有参数。
例如,如果参数是变量,则必须在发出 SqlPrepare( ) 之前创建并初始化这些变量。
提示: |
---|
X# 目前不支持参数化查询
|
- cCursorName
- 类型:String
指定结果集发送到的 X# 游标的名称。如果不包含游标名称,X# 使用默认名称 SQLRESULT。
对于多个结果集,新游标名称通过在第一个游标名称后附加一个递增的数字来派生。
返回值
类型:
Int32
数值型
备注
SqlPrepare( ) 将 SQL 语句发送到数据源,在那里编译以加快执行速度。SQL 语句编译后,
可以使用 SqlExec( ) 执行。如果 SqlExec( ) 用于执行用 SqlPrepare( ) 准备的 SQL 语句,
则在 SqlExec( ) 中只需要语句句柄。
示例 1gcAuthor = 'Smith'
2= SqlPrepare(gnHandle, 'Select * From authors; Where au_lname = ?gcAuthor')
3= SqlExec(gnHandle)
4...
5gcAuthor = 'Jones'
6= SqlExec(gnHandle)
参见