Functions.DbZap 方法 | |
从打开的文件中删除所有记录。
命名空间:
XSharp.RT
程序集:
XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法 FUNCTION DbZap() AS LOGIC
public static bool DbZap()
查看代码返回值
类型:
Boolean
如果成功则返回 TRUE;否则返回 FALSE。
备注
DBZap() 永久删除工作区中打开文件的所有记录。
这包括数据库文件、索引文件和相关的备注文件。被清除文件之前占用的磁盘空间将释放给操作系统。
如果数据库文件中的所有记录都被标记为删除,DBZap() 执行与 DBPack() 相同的操作,但几乎是瞬时完成的。
默认情况下,此函数在当前选定的工作区上操作。
可以通过在别名表达式中指定或调用接受工作区参数(工作区编号或别名)的重载来使其在未选定的工作区上操作。
此操作要求当前数据库以独占模式打开(参见 SetExclusive())。
如果在调用函数时不满足这个条件,将引发运行时错误。
否则,操作将继续进行,完成后将记录指针重置到当前工作区的第一个逻辑记录。
示例
以下示例演示了 DBZap() 的典型操作:
1USE sales EXCLUSIVE NEW
2IF !NetErr()
3 SET INDEX TO sales, branch, salesman
4 IF DBZap()
5 ? "清除成功"
6 ELSE
7 ? "清除过程中检测到错误"
8 ENDIF
9 CLOSE sales
10ELSE
11 ? "打开文件时检测到错误"
12ENDIF
参见