近期,葡萄城报表控件ActiveReports V14.0 正式发布,全面支持 .NET Core平台。同时,在本次更新中 ActiveReports的桌面报表设计器UI得以全面增强,报表预览方式得以全面优化,报表设计能力得以大幅提升。

针对在线报表设计器,ActiveReports V14.0增加了数据源及数据集的连接功能、带状列表控件,以及本地化支持。

本文,将详细介绍带状列表控件的特性及主要功能。

概要

带状列表控件是ActiveReports V14.0 在线报表设计器中新增的功能,这是一个非常强大的数据控件,分为表头、详细数据行(用于加载数据字段)、表尾三个数据区域。每个区域都可以当作一个容器控件来使用,即在每一个区域中都可以同时嵌入多个控件来创建复杂格式的报表,如主从报表、动态不固定列表等。其中,详细数据行嵌入的控件会根据行数重复渲染,而表头和表尾仅渲染一次,分别用于显示标题和总计。

选中整个控件或单击某个区域,可分别设定整个控件或单个区域的属性。

如下是整个控件的属性列表:

属性 说明
DataSetName 指定数据集
KeepTogether 设置为True表示将所有数据尽量显示在同一页面内
NewSection 设置为True表示将数据显示在一个新的区域(Section)内
OverflowName 选择一个溢出占位符控件,用于显示固定尺寸无法容纳的数据

使用带状列表控件,可以添加分组头和分组尾,也可以嵌套分组。其中,分组依据可以为表达式,分组数据可以排序。
注意:带状列表的明细区不支持排序,明细数据的排序必须在查询时完成。

如下是单个区域(Band)的属性列表:

属性 说明
CanGrow 设置为True表示允许数据区域纵向扩展以显示更多数据
CanShrink 设置为True表示允许数据区域纵向收缩以减少空白
KeepTogether 设置为True表示将所有数据尽量显示在同一页面内
PageBreakAtEnd 设置为True表示在本区域末尾强制换页
PageBreakAtStart 设置为True表示在本区域开始位置强制换页
RepeatOnNewPage 设置为True,可在明细数据跨页时,每页都显示头部或尾部

带状列表的属性对话框

选中带状列表,点击属性窗格下方的【属性对话框…】,即可打开属性对话框选项。

属性对话框包含多个选项页:常规、可见性、导航、分组、过滤、数据输出。

常规

  • 名称:代表控件名称,同一张报表范围内要保证唯一性。

  • 工具提示:输入一段文字,用户查看报表、鼠标进入本控件区域时,将显示此文本。

  • 数据集名称:选择一个与本控件绑定的数据集。

  • 区域内页码:本控件是否单独排页码。

  • 删除容器控件中的空白区域:是否自动缩减控件范围内的空白区域。

  • 换页:可选择在Banded List之前、之后插入换页,或者尽可能将全部内容显示在同一页中以避免分页。

  • 列头和列尾:可选择在每页中重复显示头部或尾部区域的内容、禁止将头部或尾部区域单独显示在一页、将尾部区域打印在页面底部(默认紧跟着明细区内容)。

可见性

默认状态下,控件在查看报表时是可见的,但是,可以设置为根据表达式结果决定是否隐藏本控件,也可以设置本控件根据报表内的另一控件的可见性决定是否隐藏。

导航

  • 文档结构图标签:输入文本或表达式,用作本控件在文档结构图(即目录)中的项目名称。

  • 书签ID:输入文本或表达式,用作跳转到本控件的书签定位ID。在其他控件处设置【跳转到书签】为这个ID,就可以在查看报表时点击其他控件跳转到本控件。

分组

分组可用于将数据按照特定的分类进行组织和统计,例如在一个产品清单报表中,默认情况会按照产品ID显示一览表,但通过设置分组,可以按照产品类别,将同一类别的产品信息在一起显示。
点击加号图标可添加新的分组,分组属性可在多个选项卡中设置。

分组 - 常规

  • 名称:输入一个分组名称。

  • 分组:选择一个字段,或者编辑一个表达式,作为分组的依据。典型的是类别性质的字段,例如产品类别ID、年度、月份、业务区域等。

  • 文档结构图标签:输入一个文本表达式,作为目录项的名称。

  • 上级分组:指定一个父级分组,以实现多级分组。

分组 - 过滤

可设定过滤条件,用来显示部分分组的数据。

一个过滤条件由三部分组成:表达式、运算符、值。

表达式:过滤条件的检查对象,一般是某个字段。

运算符:即比较操作符,具体包括:

  • Equal:相等,即过滤出左边表达式的计算结果(或某个字段值)等于某个指定值(运算符右边的值)的数据。

  • Like:包含,即过滤条件是左边的表达式包含右边的值。右边的值一般会包含星号通配符(*),可以参考微软文档:https://msdn.microsoft.com/en-us/library/swf8kaxw(v=vs.100).aspx

  • NotEqual:不等于。

  • GreaterThan:大于。

  • GreaterThanOrEqual:不小于,即大于或等于。

  • LessThan:小于。

  • LessThanOrEqual:不大于,即小于或等于。

  • TopN:只显示数据集的前几条数据,具体几条,由下面指定的【值】来确定。

  • BottomN:只显示数据集的后几条数据,具体几条,由下面指定的【值】来确定。

  • TopPercent:只显示数据集的前百分之几的部分数据,具体显示百分之几,由下面指定的【值】来确定。

  • BottomPercent:只显示数据集的后百分之几的部分数据,具体显示百分之几,由下面指定的【值】来确定。

  • In:只显示表达式结果等于几个具体值的数据,具体的值由下面指定的【值】确定。

  • Between:只显示表达式结果落在两个具体值之间的数据,两个具体的值由下面指定的【值】确定。

值:根据运算符的不同,过滤条件中运算符右边的值可能是单个常数值,也可能是多个常数值(例如在Between、In等运算符中)。

此外,值可能包含通配符,例如运算符为Like时,值可能代表"陕西省*市"。

对于TopPercent和BottomPercent运算符,值应该是不带百分号的数字部分,假设想要过滤一半数据的话,值应该是50,而不是50%或者0.5。

分组 - 排序

可以设置多个排序条件,用来控制数据输出的次序。在排序中,每个条件的升降序可以不同,比如先按年度降序、再按省份升序。

  • 表达式:可以是单个字段,也可以是几个字段的组合表达式。

  • 方向:用来控制升序或降序。

分组 - 可见性

用来设置当前分组是否隐藏。

  • 可见:总是显示,即不隐藏。

  • 隐藏:即总是不显示。

  • 表达式:根据表达式的计算结果决定是否隐藏。表达式应返回True/False 布尔类型。注意:True表示隐藏,False表示要显示。

可见性可以通过其他报表元素进行切换:选择当前报表内的另一个元素,通常是一个文本框,比如TextBox1。当用户查看报表时,文本框左边将显示一个用加号和减号表示的折叠和展开图标,用户点击该图标,当前元素将在显示与隐藏之间来回切换。

典型的应用场景是:文本框中的内容设置为"显示或隐藏明细列表",然后通过这个文本框左边的加减号点击,控制一个表格或列表是否显示。

分组 - 数据输出

此处设置报表数据导出为XML时的元素Tag。

  • 元素名称:输入一个XML元素名称,这个名称将用作报表数据输出为XML文件时的Tag。例如"ProductType"。

  • 集合:输入一个XML集合名称,这个名称将用作XML数据输出的元素名称Tag的上级Tag。例如"ProductTypes"。

  • 输出:选择【是】或【否】,表示在进行XML输出时是否包含本数据。

分组 - 布局

  • 起始位置换页:在本部分内容之前插入硬分页。

  • 结束位置换页:在本部分内容之后插入硬分页。

  • 包括分组头:显示头部区域。不勾选可隐藏头部区域。

  • 包括分组尾:显示尾部区域。不勾选可隐藏尾部区域。

  • 重复分组头:换页时是否重复头部区域。

  • 重复分组尾:换页时是否重复尾部区域。

  • 区域内页码:是否单独排页码,默认根据整个报表统一排页码。

  • 将表格分组内容打印在同一页中:当本区域内容较多,又需要在一页内显示时,可控制单独用一页显示(这样可能导致前一页下部空白)。

  • 禁止单独显示头部:不要将头部显示在一个页面的底部,即下面一行明细也没有。

  • 禁止单独显示尾部:不要将尾部显示在一个页面的顶部,即上面一行明细也没有。

  • 将尾部区域打印在页面底部:默认尾部区域紧跟数据,勾选后可强制显示在页面底部。

过滤

如果需要只显示数据集的一部分数据,可在此设置过滤条件。

点击对话框右上角的加号图标,可创建新的过滤条件。

数据输出

此处设置报表数据导出为XML时的元素Tag。

  • 元素名称:输入一个XML元素名称,这个名称将用作报表数据输出为XML文件时的Tag,例如"Product"。

  • 输出:自动=让系统决定是否导出(系统会根据某些条件决定是否导出,比如文本框内的字符串是常量时,不导出,或仅导出来自数据集的字段值内容);是=总是导出;否=不导出);仅内容=只导出数据内容。

关于带状列表控件使用过程中的任何技术问题,都可以在ActiveReports 求助中心发帖提问,我们会第一时间作出解答。

以上就是ActiveReports V14.0在线报表设计器的带状列表控件介绍,如需了解更多新特性内容,欢迎前往ActiveReports产品官网下载体验。

ActiveReports 报表控件| 下载试用

ActiveReports 是一款专注于 .NET 平台的报表控件,全面满足 HTML5 / WinForm / ASP.NET / ASP.NET MVC / WPF 等平台下报表设计和开发工作需求,作为专业的报表工具为全球超过 300,000 开发人员提供了全面的报表开发服务。

您对ActiveReports产品的任何技术问题,都有技术支持工程师提供1对1专业解答,点击此处即可发帖提问>>技术支持论坛