只读网格和可编辑网格都支持 GridAttribute。
GridAttribute 表示可编辑网格的单元格中的数据,并包含对与列关联的所有单元格的引用。 有关可用于访问集合中的数据的方法的信息 ,请参阅集合(客户端 API 参考 )。
GridAttribute 还支持所选网格行列的 控件 集合,该集合提供了处理与列关联的单元格集合的方法。 所选网格行的每个单元格(GridCell)类似于绑定到可编辑网格中的列的窗体上的控件。 有关可用于访问集合中的数据的方法的信息 ,请参阅集合(客户端 API 参考 )。
小窍门
出于性能原因,在选择记录之前,不可编辑可编辑网格中的行(记录)。 用户必须在网格中选择单个记录才能对其进行编辑。 在可编辑网格中选择记录后,Dynamics 365 内部会评估许多内容,包括用户对记录的访问权限、记录是否处于活动状态以及列验证,以确保编辑数据时遵守数据安全性和有效性。 请考虑将 OnRecordSelect 事件与 getFormContext 方法一起使用,以访问处于可编辑状态的网格中的记录。
Methods
GridAttribute 支持所选网格行列的以下方法。
| Name | Description |
|---|---|
| getName | 返回所选网格行列的逻辑名称。 |
| getRequiredLevel | 返回一个字符串值,该值指示列的值是必需还是建议的。 |
| setRequiredLevel | 设置在保存记录之前,是必需还是建议对所选网格行的列使用数据。 |
| getValue | 检索列的数据值。 |
| setValue | 设置列的数据值。 |
注释
若要在可编辑网格中选择一行,请使用 网格。getSelectedRows