GridAttribute (客户端 API 参考)

只读网格和可编辑网格都支持 GridAttribute。

GridAttribute 表示可编辑网格的单元格中的数据,并包含对与列关联的所有单元格的引用。 有关可用于访问集合中的数据的方法的信息 ,请参阅集合(客户端 API 参考 )。

GridAttribute 还支持所选网格行列的 控件 集合,该集合提供了处理与列关联的单元格集合的方法。 所选网格行的每个单元格(GridCell)类似于绑定到可编辑网格中的列的窗体上的控件。 有关可用于访问集合中的数据的方法的信息 ,请参阅集合(客户端 API 参考 )。

小窍门

出于性能原因,在选择记录之前,不可编辑可编辑网格中的行(记录)。 用户必须在网格中选择单个记录才能对其进行编辑。 在可编辑网格中选择记录后,Dynamics 365 内部会评估许多内容,包括用户对记录的访问权限、记录是否处于活动状态以及列验证,以确保编辑数据时遵守数据安全性和有效性。 请考虑将 OnRecordSelect 事件与 getFormContext 方法一起使用,以访问处于可编辑状态的网格中的记录。

Methods

GridAttribute 支持所选网格行列的以下方法。

Name Description
getName 返回所选网格行列的逻辑名称。
getRequiredLevel 返回一个字符串值,该值指示列的值是必需还是建议的。
setRequiredLevel 设置在保存记录之前,是必需还是建议对所选网格行的列使用数据。
getValue 检索列的数据值。
setValue 设置列的数据值。

注释

若要在可编辑网格中选择一行,请使用 网格getSelectedRows

GridCell
模型驱动应用中的网格和子网格
控件集合