內建集合 - 編頁報表中的參數集合參考 (Report Builder)

適用于:✔️ Microsoft Report Builder (SSRS) Power BI Report Builder ✔️ ✔️ 報表設計師 SQL Server Data Tools

編頁報表參數是您可以從運算式參考的其中一個內建集合。 您可以在運算式中包含參數,以根據使用者所做的選擇來自訂報表資料及外觀。 運算式可用於提供 [ (Fx) ] 或[運算式> ] 選項的任何報表專案屬性或 < 文字方塊屬性。 您也可以用其他方法來使用運算式控制報表的內容及外觀。 如需詳細資訊,請參閱運算式範例 (Report Builder和 SSRS)

在執行階段比較參數值與資料集欄位值時,所比較的兩個項目的資料類型必須相同。 報表參數可以是下列類型的其中一種:布林值、DateTime、整數、浮點數或文字,代表基礎資料類型字串 (String)。 如有必要,也可以將參數值的資料類型轉換成符合資料集值。 如需詳細資訊,請參閱運算式中的資料類型 (Report Builder和 SSRS)

若要在運算式中包含參數參考,您必須了解如何指定參數參考的正確語法,此語法會根據參數是單一值或多重值參數而改變。

注意

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

在運算式中使用單一值參數

下表顯示當您在運算式中加入任何資料類型之單一值參數的參考時,所要使用的語法範例。

範例 描述
=Parameters!<ParameterName>.IsMultiValue 傳回 False

檢查參數是否為多重值。 如果為 True,表示參數為多值,且為物件的集合。 如果為 False,表示參數為單一值,且為單一物件。
=Parameters!<ParameterName>.Count 傳回整數值 1。 如果是單一值參數,此計數一定會是 1。
=Parameters!<ParameterName>.Label 會傳回參數標籤,經常當做可用值下拉式清單中的顯示名稱。
=Parameters!<ParameterName>.Value 會傳回參數值。 如果尚未設定 Label 屬性,這個值會出現在可用值下拉式清單中。
=CStr(Parameters!<ParameterName>.Value) 會傳回字串形式的參數值。
=Fields(Parameters!<ParameterName>.Value).Value 會傳回與參數同名之欄位的值。

如需在篩選中使用參數的詳細資訊,請參閱新增資料集篩選、資料區篩選和群組篩選 (Report Builder和 SSRS)

在運算式中使用多重值參數

下表顯示當您在運算式中加入任何資料類型之多重值參數的參考時,所要使用的語法範例。

範例 描述
=Parameters!<MultivalueParameterName>.IsMultiValue 傳回 TrueFalse

檢查參數是否為多重值。 如果為 True,表示參數為多值,且為物件的集合。 如果為 False,表示參數為單一值,且為單一物件。
=Parameters!<MultivalueParameterName>.Count 傳回整數值。

參考值的數目。 如果是單一值參數,此計數一定會是 1。 如果是多重值參數,此計數是 0 或以上。
=Parameters!<MultivalueParameterName>.Value(0) 傳回多重值參數中的第一個值。
=Parameters!< MultivalueParameterName >.Value(Parameters!< MultivalueParameterName >.Count-1) 傳回多重值參數中的最後一個值。
=Split("Value1,Value2,Value3",",") 傳回數值的陣列。

針對多值的 String 參數建立數值陣列。 您可以在第二個參數中使用任何分隔符號來分隔。 這個運算式可用來設定多重值參數的預設值或是建立多重值參數,以傳送至子報表或鑽研報表。
=Join(Parameters!<MultivalueParameterName>.Value,", ") 傳回 String ,此值是由多值參數中以逗號分隔的值清單所組成。 您可以在第二個參數中使用任何分隔符號來聯結。

如需在篩選中使用參數的詳細資訊,請參閱報表參數 (Report Builder和報表設計師)

另請參閱

運算式 (報表產生器及 SSRS)
常用的篩選 (報表產生器及 SSRS)
加入、變更或刪除報表參數 (報表產生器及 SSRS)
教學課程:將參數新增至報表 (報表產生器)
報表產生器教學課程
運算式中的內建集合 (報表產生器及 SSRS)