編頁報表中運算式內的內建集合 (報表產生器)

適用於：✅Microsoft 報表產生器 (SSRS) ✅ Power BI 報表產生器 ✅ SQL Server Data Tools 中的報表設計師

在編頁報表的運算式中，您可以包括下列內建集合的參考：ReportItems、Parameters、Fields、DataSets、DataSources、Variables，以及報表名稱這類全域資訊的內建欄位。 並不是所有的集合都會顯示在 [運算式] 對話方塊中。 只有報表伺服器上已發行的報表，才可以在執行階段使用 DataSets 和 DataSources 集合。 ReportItems 集合是一組報表區域內文字方塊的集合，例如頁面上的文字方塊或頁面標頭中的文字方塊。

如需詳細資訊，請參閱運算式 (報表產生器)。

注意

您可以在 Microsoft 報表產生器、Power BI 報表產生器，以及 SQL Server Data Tools 的報表設計師中，建立及修改編頁報表定義 (.rdl) 檔案。

了解內建集合

下表列出可在撰寫運算式時使用的內建集合。 每一列都包含該集合的區分大小寫程式設計名稱。 該名稱即為，您是否可以使用 [運算式] 對話方塊以互動的方式新增集合的參考、範例及描述 (包含初始化及提供集合值的時間)。

內建集合	[運算式] 對話方塊中的類別目錄	範例	描述
Globals	內建欄位	=Globals.ReportName - or - =Globals.PageNumber	代表對報表很有用的全域變數，例如：報表名稱或頁碼。 永遠可以使用。 如需詳細資訊，請參閱內建的全域和使用者參考 (報表產生器)。
使用者	內建欄位	=User.UserID - 或 - =User.Language	代表有關執行報表之使用者的資料集合，例如，語言設定或使用者識別碼。 永遠可以使用。 如需詳細資訊，請參閱內建的全域和使用者參考 (報表產生器)。
參數	參數	=Parameters("ReportMonth").Value - 或 - =Parameters!ReportYear.Value	代表報表參數的集合，每個參數都可以是單一值或多重值。 處理初始化完成後才可以使用。 如需詳細資訊，請參閱參數集合參考 (報表產生器)。
Fields(<資料集>)	欄位	=Fields!Sales.Value	代表可供報表使用之資料集的欄位集合。 可在從資料來源將資料擷取至資料集之後使用。 如需詳細資訊，請參閱資料集欄位集合參考 (報表產生器)。
DataSets	不顯示	=DataSets("TopEmployees").CommandText	代表從報表定義的主體所參考的資料集集合。 不包含只用於頁首或頁尾的資料來源。 不適用於本機預覽。 如需詳細資訊，請參閱資料來源和資料集參考 (報表產生器)。
DataSources	不顯示	=DataSources("AdventureWorks2022").Type	代表從報表主體內所參考的資料來源集合。 不包含只用於頁首或頁尾的資料來源。 不適用於本機預覽。 如需詳細資訊，請參閱資料來源和資料集參考 (報表產生器)。
變數	Variables	=Variables!CustomTimeStamp.Value	代表報表變數和群組變數的集合。 如需詳細資訊，請參閱報表和群組變數集合參考 (報表產生器)。
ReportItems	不顯示	=ReportItems("Textbox1").Value	代表報表項目的文字方塊集合。 這個集合可以用來摘要頁面上的項目，以包含在頁首或頁尾中。 如需詳細資訊，請參閱 ReportItems 集合參考 (報表產生器)。

在運算式中使用集合語法

若要從運算式參照集合，請針對集合中的項目使用標準 Microsoft Visual Basic 語法。 下表顯示集合語法的範例。

語法	範例
Collection!ObjectName.Property	=Fields!Sales.Value
Collection!ObjectName("屬性")	=Fields!Sales("Value")
Collection("物件名稱").Property	=Fields("Sales").Value
Collection("成員")	=User("Language")
Collection.Member	=User.Language

相關內容

新增運算式 (報表產生器)
運算式範例 (報表產生器)