报表参数概述
本文档描述了报表参数、报表参数属性和参数值的主要用途。报表参数允许您控制报表的内容,连接相关的报表,或将它们作为函数中的参数使用。
要设计有效使用参数的报表,您需要了解参数和数据源组件协同工作、参数和表达式如何协同工作以及如何管理参数。
报表参数的主要用法
参数可以包含单个或多个值。如果它们有预定义的值(即可用值),后者可以是静态的或动态的(例如,基于查询的)集合。参数可以允许有BLANK和NULL值。报表参数的其他用法有:
创建报表参数后,您可以修改默认值和其他参数属性,例如可见性。
例如,您可能希望创建一个带有隐藏参数的报表,该参数选择特定于运行报表的用户的数据。或者,您可以根据报表参数的选择,在表项中筛选显示的结果。
报表参数属性
报表参数可以具有以下属性:
确定可接受的值的类型。允许的类型有布尔,DateTime,整数,浮动,字符串.下面列出了每种类型的可接受值:ReportParameterType默认参数类型为字符串.
参数名称。使用它来访问参数。名称必须是有效的标识符—只能包含数字(0-9)、字母(a-z、a-z)和下划线(_)。必须以字母或下划线开头。
用于为参数指定值。它可以是空白、允许类型的值、计算结果为允许类型的值的Expression或包含允许类型的值的IEnumerable。
当一个参数接受多个值(MultiValue=True)时,您可以通过编程方式为允许的类型分配一个IEnumerable来设置该值。
指定要在报表查看器中作为提示显示给最终用户的参数的文本。它可以是空白,字符串或表达式。如果未设置,则的名字的参数将被使用。
在使用Expression设置属性时,不应使用数据字段,并且它们不会分别列在编辑表达式对话框.
指定编辑器是否在参数区域中具有UI。如果你打开可见属性,则在报表设计器或报表查看器中预览报表时,将显示参数区域。
确定是否零(没有什么在VB.NET中)值是可以接受的。
仅在参数为类型时应用字符串.确定空字符串是否可接受。
的值的集合是否类型)是可接受的参数值。参数与多值开着的主要用在在逻辑运算符。
可用值或有效值是一组预定义值,可作为参数的值接受。每个可用值都可能有标签,如果参数是可见的,则会显示标签。要为参数定义可用值,需要设置以下嵌套属性:
数据源-值/标签对的数据源。所支持的数据源与数据项,包括Telerik报告数据源组件.
ValueMember属性的列名、表达式或嵌入表达式数据源模式。它被用作值/标签对中的值。
DisplayMember属性的列名、表达式或嵌入表达式数据源模式。它被用作值/标签对中的标签。如果省略ValueMember将被用作DisplayMember也可选的。
在设计时,您可以使用数据源向导选择现有的数据源或创建新的数据源。控制在报告本中的参数合并。Mergeable属性的默认值为true。如果你想阻止一个参数与其等价的参数合并,那么将Mergeable属性设置为false。
确定在更改参数的值后是否触发报告预览。仅应用于可见参数。默认值为假.
报表参数验证
当报表进入处理阶段时,将根据其验证属性对其值进行验证。如果一个或多个参数没有有效值,处理将中止。以下属性用于验证提供的参数的值:
类型
AllowNull
AllowBlank
多值
AvailableValues
向报表参数传递一个值
参数通过设置价值财产。您可以将此属性设置为一个有效值或一个计算为有效值的表达式。在处理报表时执行表达式计算和验证。用作参数值的表达式不能包含对内置字段集合,因为在处理参数时仍未填充字段。
报告参数的值可以通过以下方式之一填充:
在设计时通过ReportParameter集合编辑器
使用每个报表查看器提供的自动用户界面。
通过编程方式使用ReportParameters收集。
使用一个SubReports参数收集。
级联(依赖)参数
级联参数提供了一种在参数之间创建依赖关系以处理大量输入数据的方法。可以定义一组参数,其中一个参数的可用值列表取决于在其他参数中选择的值。
例如,第一个参数可以显示产品类别列表。当用户选择一个类别时,第二个参数将更新为该类别中的子类别列表。第三个参数可以显示所选子类别中的产品列表。product参数的值用于将报表筛选到特定的产品。与其他参数值相依赖的参数称为级联参数、依赖参数或分层参数。更多级联参数的使用方法,请参考以下文档:
报表参数作为一个整体处理。在它的所有依赖项(例如,其他Report Parameter值)完成评估之后,开始对其进行评估。例如,如果文本属性使用可求值的表达式和价值属性依赖于另一个报表参数,该参数的值未知/无效,则文本和值属性都不会被设置。
参数区域
当至少一个报表参数具有可见属性打开后,将显示一个参数区域作为报表查看器的一部分。这有助于报表开发人员方便地为最终用户提供输入法。根据参数的设置,将创建合适的编辑器UI。参数区域中的参数布局将自动格式化。的顺序由参数出现的顺序决定ReportParameters收集。最终用户可以在编辑器中输入或选择值。的情况下,至少有一个可见报表参数具有AutoRefresh财产关闭,一个预览按钮可用。在这种情况下,要预览报告,最终用户必须单击预览按钮。如果所有参数都为默认值,则报表在第一次查看时自动运行。控件的参数区域可以显示或隐藏参数报表查看器工具栏中的按钮。