Functions.DbTotal 方法 | |
根据键值将记录汇总到数据库文件中。
命名空间:
XSharp.RT
程序集:
XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法 FUNCTION DbTotal(
cTargetFile,
cbKey,
acFields,
cbForCondition,
cbWhileCondition,
nNext,
nRecord,
lRest,
lNoOpt
) AS LOGIC CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static bool DbTotal(
__Usual cTargetFile = default,
__Usual cbKey = default,
__Usual acFields = default,
__Usual cbForCondition = default,
__Usual cbWhileCondition = default,
__Usual nNext = default,
__Usual nRecord = default,
__Usual lRest = default,
__Usual lNoOpt = default
)
查看代码参数
- cTargetFile (Optional)
- 类型:__Usual
用于写入汇总记录的目标数据库文件名,包括可选的驱动器、目录和扩展名。有关文件搜索和创建规则,请参见 SetDefault() 和 SetPath()。
数据库文件的默认扩展名由 RDD 确定。
如果 cTargetFile 不存在,则创建它。
如果存在,此函数会尝试以独占模式打开文件,如果成功,则会覆盖文件,不会发出警告或错误。
如果由于另一个进程正在使用该文件等原因而被拒绝访问,NetErr() 将被设置为 TRUE。
- cbKey (Optional)
- 类型:__Usual
以代码块形式指定的键表达式。 - acFields (Optional)
- 类型:__Usual
要汇总的字段,以字符串数组形式指定。 - cbForCondition (Optional)
- 类型:__Usual
定义范围内每条记录必须满足的条件的代码块,以便进行处理。 - cbWhileCondition (Optional)
- 类型:__Usual
定义每条记录必须满足的另一个条件的代码块,以便进行处理。 一旦遇到导致条件失败的记录,操作就会终止。
如果未指定范围,cbWhileCondition 会将默认范围更改为 lRest。
您可以使用这三个互斥参数之一来定义范围。
默认是所有记录。
- nNext (Optional)
- 类型:__Usual
要处理的记录数,从 nRecord 开始。 指定 0 以忽略此参数。 - nRecord (Optional)
- 类型:__Usual
要处理的单个记录号。指定 0 以忽略此参数。 - lRest (Optional)
- 类型:__Usual
TRUE 仅处理从 nStart 到文件末尾的记录。 FALSE 处理所有记录。 - lNoOpt (Optional)
- 类型:__Usual
禁用(Rushmore)优化(尚不支持)。
返回值
类型:
Boolean
如果成功则返回 TRUE;否则返回 FALSE。
备注 提示: |
---|
nNext、nRecord 和 lRest 参数是互斥的。您不应同时传递这三个参数。
如果您传递 cbWhile 参数,那么它也会控制范围行为。
|
DBTotal() 在功能上等同于 TOTAL 命令。
示例
以下示例生成 Salary 和 Age 字段的汇总:
1DBTotal("totals", {||Last}, {"salary", ;
2 "age"})
参见