力控组态软件ForceControl V7.0的专家报表的关系数据库函数

ExecuteSQL

语法： #report.ExecuteSQL(nSheetIndex, strSQL);

说明： 执行标准 SQL 语句。

返回值： 执行成功返回 1；否则返回 0。

参数： nSheetIndex：当前要操作的页，-1 表示当前页；页索引号从 0 开始，取值范围为 0 到表页数减 1。

strSQL：要执行的 SQL 语句。

示例： #Report.ExecuteSQL(-1,”select * from table1″);// 在当前表页执行 SQL

SqlQuery

语法： #report.SqlQuery(nSheetIndex, nModeSql);

说明： 按条件查询。

返回值： 执行成功返 1，否则返回 0。

参数： nSheetIndex：当前要操作的页，-1 表示当前页；页索引号从 0 开始，取值范围为 0 到表页数减 1。

nModeSql：取值范围 0 和 1；0 表示使用向导生成查询条件；1 表示调用组态时设置好的查询条件。

示例： #report.SqlQuery(0, 1); 当前页调用组态时设置好的查询条件查询

SqlQueryEx

语法： #Report.SqlQueryEx(nSheetIndex, strModeSql);

说明： 条件查询

返回值： 设置成功返回 1, 否则返回 0

参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1

strModeSql：要使用的查询语句

示例 ： #Report.SqlQuery(0, “select [ 时间 ],[ 字段 1],[ 字段 2], from [tab1] “);

UpdateRecord

语法： #report.UpdateRecord(nSheetIndex);

说明： 数据提交函数，修改数据后，调用该函数写入关系数据库。

返回值： 执行成功返回 1；否则返回 0。

参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1。

示例： #report.UpdateRecord(0); // 将第一表页的数据写入其关联的关系数据库

UpdateRecordEx

语法： #Report.UpdateRecordEx(nSheetIndex, nStartRow, nRecordCnt);

说明： 数据提交函数

返回值： 设置成功返回 1, 否则返回 0

参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1

nStartRow：需要更新的关系数据库中的在表页中的起始行，-2 表示当前所选行

nRecordCnt：需要更新的记录条数

示例： #Report.UpdateRecord(-1, 1, 2);// 将当前页从第 1、2 行的数据写入关系数据库

SetConnectStr

语法： nResult = #report.SetConnectStr(nSheetIndex,nConnectType,strConnectStr,strTableName)

说明： 设置关系数据库连接字符串，并打开指定表格

返回值： 执行成功返回 1，否则返回 0

参数： nSheetIndex: 指定要操作的表页，-1 表示当前页；表页索引号取值范围 0 到表页数减 1

nConnectType: 连接串类型，0- 连接字符串；1- 组态下已配置好的数据源名称

strConnectStr: 数据库连接串或已配置好的数据源名称

strTableName: 要打开的数据表的名称，如果为空则打开第一个表格

示例： #report.SetConnectStr(-1, 1, “Test”,”test”); // 打开数据源名称为 Test 的数据库的 test 表