運算式中的內建集合 (報表產生器及 SSRS)
在報表中的表達式中,您可以包含下列內建集合的參考:ReportItems、Parameters、Fields、DataSets、DataSources、Variables 和內建字段,以取得全域資訊,例如報表名稱。 並不是所有的集合都會顯示在 [運算式] 對話方塊中。 只有報表伺服器上已發行的報表,才可以在執行階段使用 DataSets 和 DataSources 集合。 ReportItems 集合是報表區域中文本框的集合,例如,頁面或頁首上的文本框。
如需詳細資訊,請參閱運算式 (報表產生器和 SSRS)。
注意
您可以在 sql Server Data Tools 的 報表產生器 和 報表設計師 中建立和修改報表定義 (.rdl)。 每個撰寫環境提供不同的方式來建立、開啟及儲存報表和相關專案。 如需詳細資訊,請參閱在web上設計 報表設計師和 報表產生器 (SSRS) 中的報表,網址為 microsoft.com。
了解內建集合
下表列出可在撰寫運算式時使用的內建集合。 每一列都包含該集合的區分大小寫程式設計名稱,以及您是否可以使用 [運算式] 對話方塊以互動的方式加入集合的參考、範例及描述 (包含初始化及提供集合值的時間)。
內建集合 | [運算式] 對話方塊中的類別目錄 | 範例 | 描述 |
---|---|---|---|
Globals |
內建欄位 | =Globals.ReportName - or - =Globals.PageNumber |
代表對報表很有用的全域變數,例如:報表名稱或頁碼。 永遠可以使用。 如需詳細資訊,請參閱內建全域和使用者參考 (報表產生器和 SSRS)。 |
User |
內建欄位 | =User.UserID - 或 - =User.Language |
代表有關執行報表之使用者的資料集合,例如,語言設定或使用者識別碼。 永遠可以使用。 如需詳細資訊,請參閱內建全域和使用者參考 (報表產生器和 SSRS)。 |
Parameters |
參數 | =Parameters("ReportMonth").Value - 或 - =Parameters!ReportYear.Value |
代表報表參數的集合,每個參數都可以是單一值或多重值。 處理初始化完成後才可以使用。 如需詳細資訊,請參閱參數集合參考 (報表產生器和 SSRS)。 |
Fields( <數據> ) |
欄位 | =Fields!Sales.Value |
代表可供報表使用之資料集的欄位集合。 可在從資料來源將資料擷取至資料集之後使用。 如需詳細資訊,請參閱資料集 Fields 集合參考 (報表產生器和 SSRS)。 |
DataSets |
不顯示 | =DataSets("TopEmployees").CommandText |
代表從報表定義的主體所參考的資料集集合。 不包含只用於頁首或頁尾的資料來源。 不適用於本機預覽。 如需詳細資訊,請參閱 DataSources 和 DataSets 集合參考 (報表產生器和 SSRS)。 |
DataSources |
不顯示 | =DataSources("AdventureWorks2012").Type |
代表從報表主體內所參考的資料來源集合。 不包含只用於頁首或頁尾的資料來源。 不適用於本機預覽。 如需詳細資訊,請參閱 DataSources 和 DataSets 集合參考 (報表產生器和 SSRS)。 |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
代表報表變數和群組變數的集合。 如需詳細資訊,請參閱報表和群組變數集合參考 (報表產生器和 SSRS)。 |
ReportItems |
不顯示 | =ReportItems("Textbox1").Value |
代表報表項目的文字方塊集合。 這個集合可以用來摘要頁面上的項目,以包含在頁首或頁尾中。 如需詳細資訊,請參閱 ReportItems 集合參考 (報表產生器和 SSRS)。 |
在運算式中使用集合語法
若要從運算式參照集合,請針對集合中的項目使用標準 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 |