脏概念定义如下:
- 通常,只有单元格值的变更才导致其成为脏数据。
- 如果单元格是脏数据,其所在的行也将是脏数据。
- 如果插入了一行并为其中的一个单元格设置了值,那么此行将只是一个插入的行,而不是脏数据。被设值的那个单元格也不是脏数据。
- 加载绑定数据的项不是脏数据,但是,在通过
spreadSheet
修改绑定数据之后,它将变为脏数据。 - 脏数据的状态不会因为撤销操作而改变。
你可以通过调用表单上的getDirtyRows
方法来获取所有的脏行。如果存在绑定的数据,用户可以从脏行中获取row
,item
, 和originalItem
信息。否则,只能获得行数据。
你可以通过调用getDirtyCells
方法来获取脏单元格。当指定区域时,需要提供以下的操作参数。
- row: 区域中左上方单元格的行索引值。
- col: 区域中左上方单元格的列索引值。
- rowCount: 区域行数目。
- colCount:区域列数目。
每一个脏单元格都提供这些信息: row, col, oldValue, newValue.
你可以通过调用表单上的 getDeletedRows
方法来获取所有删除的行。如果存在绑定数据,用户可以从脏行中获取 row
和 originalItem
信息。否则,只能获得行数据。
你可以通过调用表单上的 getInsertRows
方法来获取所有插入的行。每一个插入的行都提供 行 和 项目 信息。
脏,插入和删除状态可以通过 clearPendingChanges
方法清除。在调用 setRowCount
, setColumnCount
, fromJSON
, 或者 setDataSource
方法之后,它们也会被自动清除。你也可以按范围清除脏/插入/删除状态。会提供可选对象参数的clearChangeInfo
以指定清除操作.
- clearChangeInfo.row: [optional] 清除区域的行索引
- clearChangeInfo.col: [optional] 清除区域的列索引
- clearChangeInfo.rowCount: [optional] 清除区域的行数
- clearChangeInfo.colCount: [optional] 清除区域的列数
- clearChangeInfo.clearType: [optional] 清除挂起的更改的类型,包括脏/插入/删除,默认为脏,该值为
GC.Spread.Sheets.ClearPendingChangeType
的枚举