修改数据集

当应用程序打开一个实体数据集时，数据集自动进入 浏览(browse) 状态。 “浏览” 状态允许您查看数据集中的记录，但您不能编辑记录或插入新记录。 在数据集中，您主要使用 “浏览” 状态来从一条记录切换到另一条记录。

有关在记录之间切换的更多信息，请参阅 导航数据集 。

可以将数据集从 “浏览” 状态设置为其他状态。例如，调用 insert 或 append 方法会将其状态从 “浏览” 更改为 “插入” 。

有两种方法可以将数据集返回到 “浏览” 状态。 取消(Cancel) 结束对当前记录的编辑、插入操作，并将数据集返回到 “浏览” 状态。 提交(Post) 将对当前记录的更改写入数据集。如果成功，也会将数据集返回到 “浏览” 状态； 如果提交操作失败，则当前状态保持不变。

要检查数据集状态，请使用 item_state 属性或 is_new 、 is_edited 或 is_changing 方法：

客户端	服务器端	描述
item_state	item_state	表示实体数据集的当前操作状态。
is_new	is_new	如果实体数据集处于 插入 状态，则返回 true。
is_edited	is_edited	如果实体数据集处于 编辑 状态，则返回 true。
is_changing	is_changing	如果实体数据集处于 插入 或 编辑 状态，则返回 true。

您可以使用以下实体对象的方法在数据集中插入、更新和删除数据：

客户端	服务器端	描述
edit	edit	将实体数据集置于编辑状态。
append	append	将一条记录追加到数据集的末尾，并将数据集置于 插入 状态。
insert	insert	在数据集的开始处插入一条记录，并将数据集置于 插入 状态。
post	post	保存新的或更改过的记录，并将数据集置于 “浏览” 状态。
cancel	cancel	取消当前操作，并将数据集置于 “浏览” 状态。
delete	delete	删除当前记录，并将数据集置于 “浏览” 状态。

对数据集所做的所有更改都存储在内存中，对实体记录的更改会写入日志。 因此，在完成所有更改后，可以通过调用 apply 方法生成并执行 SQL 查询，将所有更改存储到关联的数据库表中。

客户端	服务器端	描述
log_changes	log_changes	表示是否记录数据更改。
apply	apply	将实体数据集中所有更新、插入和删除的记录发送到服务器，以写入数据库。