Studio Web 用户指南

适用平台：

上次更新日期 2025年11月25日

编辑网格

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

Demo: Edit Grid

Download the Apps_Tables_Cheatsheet.zip demo app and import it into UiPath Studio Web to see an example of how the Edit Grid control can be used to build a Table cheatsheet for displaying and updating data.

常规

数据源- 要在网格内编辑的数据源。默认情况下，使用“记录”活动创建工作流。您还可以引用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 数据源。

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

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

Processes.ALLDATATYPES.out_datatable.ToListSource()Processes.ALLDATATYPES.out_datatable.ToListSource()

Using entities with Table and Edit Grid controls

Check out Use tabular controls with Data Service entities in app projects for more information on how to use entities with Table and Edit Grid controls.

备注：

Formatting dates is not supported using Table and Edit grid controls. When using date columns, the DateTime type is displayed without additional formatting (shown as raw values). In contrast, DateOnly type columns are automatically formatted based on the user’s browser locale and language settings.
When working with entities, it is recommended to use the Create Workflow option to enable pagination. Using an Entity App variable as Data source is not advised, as it creates a local copy of the data and does not support pagination from Data Fabric.