编辑网格

“编辑网格”控件用于列出、编辑、分页或搜索表格记录。

演示：编辑网格

下载Apps_Tables_Ceatsheet.zip演示应用程序并将其导入 UiPath Studio Web，查看示例，了解如何使用“编辑网格”控件构建用于显示和更新数据的表格备忘单。

常规

• 数据源- 要在网格内编辑的数据源。 默认情况下，使用“记录”活动创建工作流。 您还可以引用Apps 数据源类型的对象。

  获取数据源后，网格会自动检测数据列。单击每列的“更多”图标可导航至以下属性：

  • “名称”- 列标题的显示名称。

  • 来源 - 被引用实体的字段。

  • 编辑模式视图 - 确定如何与列交互：

    编辑模式视图选项	描述
    文本框	列中单元格的行为类似于文本框控件。
    日期选取器	列中单元格的行为类似于日期选取器控件。
    复选框	列中单元格的行为类似于复选框控件。
    下拉列表	列中单元格的行为类似于下拉控件。
    多选	列中单元格的行为类似于多选控件。

  • 隐藏 - 如果为 True，则在运行时隐藏列。

  • 可编辑 - 如果为 False，则将列的内容标记为只读。

• 添加新列 - 通过单击加号“+”图标向数据添加新列。

• 隐藏 - 如果为 True，则在 Runtime 隐藏该控件。

• 可编辑 - 如果为 False，则将控件标记为只读。

• 添加行 - 如果为 True，则允许应用程序用户在 Runtime 添加新行。如果为 False，则用户无法添加新行。

• 删除行 - 如果为 True，则允许应用程序用户删除行。如果为 False，则用户无法删除行。

• 搜索 - 如果为 True，则公开内置搜索功能。

备注：

“编辑网格”中的“日期选取器”不支持编辑包含时间值的列类型。使用“排除时间” 选项配置 Data Service 实体中的列，以避免数据错误。

如果需要包含时间列，请将列的“编辑模式视图”选项设置为“文本框”类型。

Events

• 选定的行 - 配置选定行时会发生的情况。

• 添加的文件 - 配置添加文件时会发生的情况。

• 修改的行 - 配置修改行时会发生的情况。

• 删除的行 - 配置删除行时会发生的情况。

样式

• “控件对齐”- 默认情况下，继承父级对齐方式。可以设置与父级对齐方式不同的对齐方式。要默认返回到父级对齐方式，请取消选择覆盖的选项。

  注意：对齐方式取决于为父元素选择的布局（垂直与水平）。

• “背景颜色”- 网格标头和网格正文的背景颜色。

• “边框”- 控件的边框。可以配置边框粗细、颜色和半径。

• “字体”- 列标头和列正文文本的字体属性，例如字体系列、大小、颜色或样式（粗体、斜体和下划线）。默认情况下，控件会继承直属父容器的字体系列，这由关键字“已继承”指示。

• “边距”- 设置控件的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。

• “大小”- 控件的宽度和高度。默认情况下，大小设置为 auto。要设置最小值或最大值，请单击三点图标 (...)。如果控件的大小小于选项的大小，则系统会显示滚动条。

VB 属性

VB 属性	数据类型	描述
SelectedItem	Apps.Controls.TabularInitClass	引用控件中当前选定的项目。
DataSource	Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)	引用“表格” 控件内值的数据源。
NewItem	Apps.Controls.TabularInitClass	引用“添加行” 选项正在创建的项目。 “添加的行”事件引用此属性。
Editable	布尔值	确定“编辑网格”是否可编辑。
AddRows	布尔值	确定是否可以将行添加到编辑网格。
DeleteRows	布尔值	确定是否可以从“编辑网格”中删除行。
RowIndex	整数	引用行的索引以进行更新和删除操作。 应用于整个数据集位于内存中的流程集成。
Search	布尔值	启用或禁用搜索功能。 如果为 true，则启用搜索。
Value	Apps.Controls.TabularInitClass	控件的当前选定值。
Hidden	布尔值	如果为 True，则在 Runtime 隐藏该控件。
Disabled	布尔值	如果为 True，则在 Runtime 禁用该控件。

将复杂数据转换为 Apps 数据源

要将数据表或复杂数据类型转换为 Apps 数据源，请执行以下操作：将数据表保存到变量中，然后使用 .ToListSource 方法将数据表中的数据转换为 Apps 数据源。

1. 将数据保存到数据表类型的变量中。例如，将变量命名为“dt”。
2. 在表格控件的“数据源”字段中，使用以下表达式：

   dt.ToListSource()

通常，可以使用以下语法将复杂对象转换为 Apps 数据源：

Processes.ALLDATATYPES.out_datatable.ToListSource()

将实体与“表格”和“编辑网格”控件一起使用

有关如何将实体与“表”和“编辑网格”控件一起使用的更多信息，请查看在应用程序项目中将表格控件与 Data Service 实体一起使用。

备注：

• 不支持使用“表格”和“编辑”网格控件设置日期格式。使用日期列时，日期时间类型显示为不带其他格式（显示为原始值）。相比之下，系统会根据用户的浏览器区域设置和语言设置自动格式化“仅日期”类型列的格式。
• 使用实体时，建议使用“创建工作流”选项启用分页。不建议使用实体应用程序变量作为数据源，因为它创建数据的本地副本，并且不支持从 Data Fabric 分页。