脏数据可以帮助你获得变更的的数据。脏数据可以是插入的行,删除的行,更新的行(含有更新单元格的行),或者更新的单元格。
脏概念定义如下:
- 通常,只有单元格值的变更才导致其成为脏数据。
- 如果单元格是脏数据,其所在的行也将是脏数据。
- 如果插入了一行并为其中的一个单元格设置了值,那么此行将只是一个插入的行,而不是脏数据。被设值的那个单元格也不是脏数据。
- 加载绑定数据的项不是脏数据,但是,在通过 excel 修改绑定数据之后,它将变为脏数据。
- 脏数据的状态不会因为撤销操作而改变。
- 你可以通过调用表单上的 getDirtyRows 方法来获取所有的脏行。如果存在绑定的数据,用户可以从脏行中获取 row, item, 和 originalItem 信息。否则,只能获得行数据。
你可以通过调用 getDirtyCells 方法来获取脏单元格。当指定区域时,需要提供以下的操作参数。
- row: 区域中左上方单元格的行索引值。
- col: 区域中左上方单元格的列索引值。
- rowCount: 区域行数目。
- colCount:区域列数目。
- 每一个脏单元格都提供这些信息: row, col, oldValue, newValue.
你可以通过调用表单上的 getDeletedRows 方法来获取所有删除的行。如果存在绑定数据,用户可以从脏行中获取 row 和 originalItem 信息。否则,只能获得行数据。
你可以通过调用表单上的 getInsertRows 方法来获取所有插入的行。每一个插入的行都提供 row 和 item 信息。
脏,插入和删除状态可以通过 clearPendingChanges 方法清除。在调用 setRowCount, setColumnCount, fromJSON, 或者 setDataSource 方法之后,它们也会被自动清除。