点击或拖拽改变大小

Functions.DbZap 方法

X#
从打开的文件中删除所有记录。

命名空间:  XSharp.RT
程序集:  XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法
 FUNCTION DbZap() AS LOGIC
查看代码

返回值

类型:Boolean
如果成功则返回 TRUE;否则返回 FALSE。
备注
DBZap() 永久删除工作区中打开文件的所有记录。
这包括数据库文件、索引文件和相关的备注文件。被清除文件之前占用的磁盘空间将释放给操作系统。
如果数据库文件中的所有记录都被标记为删除,DBZap() 执行与 DBPack() 相同的操作,但几乎是瞬时完成的。
默认情况下,此函数在当前选定的工作区上操作。
可以通过在别名表达式中指定或调用接受工作区参数(工作区编号或别名)的重载来使其在未选定的工作区上操作。
此操作要求当前数据库以独占模式打开(参见 SetExclusive())。
如果在调用函数时不满足这个条件,将引发运行时错误。
否则,操作将继续进行,完成后将记录指针重置到当前工作区的第一个逻辑记录。
示例
以下示例演示了 DBZap() 的典型操作:
X#
 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
参见