append

append()

使用范围: client

编程语言: javascript

父类: Item 类

描述说明

在数据集末尾,打开一个新的空记录。

在调用 append 之后,应用程序能使用户在记录的字段中输入数据,然后使用 post 方法将用户的输入提交到实体项的数据集中,最后,使用 apply 方法,将修改的内容保存到实体项在数据库中对应的数据表中。

append 方法

  • 检查实体项的数据集是否处于 active 状态, 如果不是,会抛出异常

  • 如果实体项是一个 明细项(detail) , 那么会检查主实体是否处于 “编辑” 或 “插入” active 状态, 如果不是,会抛出异常

  • 如果实体项不是一个 明细项(detail) , 那么会检查它是否处于 “浏览” active 状态, 如果不是,会抛出异常

  • 如果为实体项定义了 on_before_append 事件处理程序,那么会触发它。

  • 在数据集末尾,打开一个新的空记录。

  • 将实体项置于 “插入” 状态

  • 如果为实体项定义了 on_after_append 事件处理程序,那么会触发它。

  • 更新 数据感知控件

另请参见

修改数据集