分页报表中的报表和组变量引用（报表生成器）

适用范围：✅ Microsoft 报表生成器 (SSRS) ✅ Power BI Report Builder ✅ SQL Server Data Tools 中的报表设计器

如果需要在报表的表达式中多次使用某个复杂计算，可能需要创建一个变量。您可以创建一个报表变量或组变量。变量名称在报表中必须是唯一的。

注意

在 SQL Server Data Tools 中，你可以在 Microsoft 报表生成器、Power BI 报表生成器和报表设计器中创建和修改分页报表定义 (.rdl) 文件。

报表变量

使用报表变量可保存时间相关的计算的值（例如货币汇率或时间戳），或者保存多次引用的复杂计算的值。默认情况下，报表变量计算一次即可在报表中的表达式中使用。报表变量默认为只读。您可以更改该默认设置以使报表变量成为读写的。在再次处理该报表之前，报表变量中的值将保留在整个会话中。

要添加报表变量，请打开“报表属性”对话框，选择“变量”，然后提供名称和值。名称是区分大小写的字符串，以字母开头，不含空格。名称可以包含字母、数字或下划线 (_)。

若要引用表达式中的变量，请使用全局集合语法，例如 =Variables!CustomTimeStamp.Value。在设计图面上，文本框中的值显示为 <<Expr>>。

可以按下列方式使用报表变量：

只读使用：设置值一次以便为报表会话创建一个常量，例如创建一个时间戳。

因为当用户在报表中翻页时，文本框中的表达式将按需计算，所以，如果用户通过使用“上一页”按钮向前和向后翻页，动态值（例如，包括返回时间的 Now() 函数的表达式）可以返回不同的值。通过将报表变量的值设置为表达式 =Now()，然后在表达式中添加变量，可确保整个报表处理过程中使用相同的值。
读写使用：设置值一次并在报表会话中序列化该值。变量的读写选项提供了一个比在报表定义的代码块中使用静态变量更好的选择。

如果清除了某一变量的“只读”选项，则该变量的 Writable 属性将设置为 true。要从某一表达式更新值，请使用 SetValue 方法，例如 =Variables!MyVariable.SetValue("123")。

注意

无法控制报表处理器何时初始化一个变量或何时对更新变量的表达式进行计算。变量初始化的执行顺序未定义。

有关会话的详细信息，请参阅“在报表生成器中预览报表”。

使用组变量可在组的作用域中计算一次复杂表达式。组变量仅在组及其子组的作用域中有效。

例如，假定一个数据区域显示不同税收类别项目的库存数据，您希望对每种类别分别采用不同的税率。可以对 Category 中的数据进行分组，并对父组定义一个 Tax 变量。然后为每个税收类别的 ItemTax 定义一个组变量，再将每个不同的 Category 子组分配给正确的组变量。例如：

对于基于 [Category]的父组，使用 值定义变量 Tax [Tax]。假定类别值为 Food 和 Clothing。
对于基于 [Subcategory]的子组，将变量 ItemsTax 定义为 =Variables!Tax.Value * Sum(Fields!Price.Value)。假定 Food 类别中的子类别值为 Beverages 和 Bread。假定 Clothing 类别中的子类别值为 Shirts 和 Hats。
在子组行中的文本框添加表达式 =Variables!ItemsTax.Value。

文本框中显示按照 Food 税计算的 Beverages 和 Bread 以及按照 Clothing 税计算的 Shirts 和 Hats 的总税额。

要添加组变量，请打开“Tablix 组属性”对话框，选择“变量”，然后提供名称和值。组变量在每个唯一组值中计算一次。

若要引用表达式中的变量，请使用全局集合语法，例如 =Variables!GroupDescription.Value。在设计图面上，文本框中的值显示为 <<Expr>>。