Show/Hide Toolbars

XSharp

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()