Note | 该命令在头文件中定义,将由 X# 预处理器预处理为函数调用。如果禁用标准头文件 (-nostddefs),该命令将不可用。如果告诉编译器使用不同的标准头文件(-stddef ),则此命令也可能不可用。 |
在当前数据库文件末尾添加一条新记录,使其成为当前记录。
APPEND BLANK [[IN|ALIAS] <workarea>]
参数
IN | ALIAS <workarea> | 指定执行操作的工作区。 |
新字段值初始化为每种数据类型的空值:字符字段赋值为空格;数字字段赋值为 0;逻辑字段赋值为 FALSE;日期字段赋值为 NULL_DATE;备忘字段留空。
对于共享数据库,APPEND BLANK 会自动为新记录加锁。 如果记录无法锁定,NetErr() 将被设置为 “true”,表示记录未被添加,然后继续执行。
注意:APPEND BLANK 不会释放当前进程设置的任何文件锁。
如果 NetErr() 返回 FALSE,说明记录已成功添加并锁定,可以开始更新。 新添加的记录将保持锁定状态,直到您明确释放锁(例如使用 UNLOCK)、关闭数据库文件或尝试另一个锁。
本例尝试向共享数据库文件添加记录,并使用 NetErr() 测试操作是否成功:
USE sales SHARED NEW
<一些语句>...
APPEND BLANK
IF !NetErr()
<更新 EMPTY 记录>...
ELSE
? "追加操作失败的处理"
BREAK
ENDIF
XSharp.RT.DLL
APPEND FROM, DBAppend(), DBRLock(), FLock(), NetErr(), RLock()