參數集合參考 (報表產生器及 SSRS)
報表參數是您可以從表達式參考的其中一個內建集合。 您可以在運算式中包含參數，以根據使用者所做的選擇來自訂報表資料及外觀。 運算式可用於提供 (Fx) 或 <運算式> 選項的任何報表項目屬性或文字輸入框屬性。 您也可以用其他方法來使用運算式控制報表的內容及外觀。 如需詳細資訊，請參閱運算式範例 (報表產生器和 SSRS)。
在執行階段比較參數值與資料集欄位值時，所比較的兩個項目的資料類型必須相同。 報表參數可以是下列類型的其中一種：布林值、DateTime、整數、浮點數或文字，代表基礎資料類型字串 (String)。 如有必要，也可以將參數值的資料類型轉換成符合資料集值。 如需詳細資訊，請參閱運算式中的資料類型 (報表產生器和 SSRS)。
若要在運算式中包含參數參考，您必須了解如何指定參數參考的正確語法，此語法會根據參數是單一值或多重值參數而改變。
注意
您可以在 SQL Server Data Tools 的 報表產生器 和 報表設計師 中建立和修改報表定義 （.rdl）。 每個撰寫環境提供不同的方式來建立、開啟及儲存報表和相關專案。 如需詳細資訊，請參閱在 microsoft.com 的Web上設計 報表設計師和 報表產生器 （SSRS） 中的報表。
在運算式中使用單一值參數
下表顯示當您在運算式中加入任何資料類型之單一值參數的參考時，所要使用的語法範例。
| 範例 | 描述 |
|---|---|
=Parameters!<ParameterName> .IsMultiValue |
傳回 False。檢查參數是否為多重值。 如果 True為 ，則參數為 multivalue，而且它是 物件的集合。 如果 False為 ，則參數為單一值，而且是單一物件。 |
=Parameters!<ParameterName> .Count |
傳回整數值 1。 如果是單一值參數，此計數一定會是 1。 |
=Parameters!<ParameterName> .Label |
會傳回參數標籤，經常當做可用值下拉式清單中的顯示名稱。 |
=Parameters!<ParameterName> .Value |
會傳回參數值。 如果尚未設定 Label 屬性，這個值會出現在可用值下拉式清單中。 |
=CStr(Parameters! <ParameterName> .Value) |
會傳回字串形式的參數值。 |
=Fields(Parameters!<ParameterName> .Value).Value |
會傳回與參數同名之欄位的值。 |
如需在篩選中使用參數的詳細資訊，請參閱新增資料集篩選、資料區域篩選與群組篩選 (報表產生器和 SSRS)。
在運算式中使用多重值參數
下表顯示當您在運算式中加入任何資料類型之多重值參數的參考時，所要使用的語法範例。
| 範例 | 描述 |
|---|---|
=Parameters!<MultivalueParameterName> .IsMultiValue |
傳回 True 或 False。檢查參數是否為多重值。 如果 True為 ，則參數為 multivalue，而且是 物件的集合。 如果 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 回 ，其中包含多重值參數中以逗號分隔的值清單。 您可以在第二個參數中使用任何分隔符號來聯結。 |
如需在篩選中使用參數的詳細資訊，請參閱報表參數 (報表產生器和報表設計師)。
另請參閱
運算式 (報表產生器及 SSRS)
常用的篩選 (報表產生器及 SSRS)
加入、變更或刪除報表參數 (報表產生器及 SSRS)
教學課程：將參數新增至報表 (報表產生器)
教學課程（報表產生器）
運算式中的內建集合 (報表產生器及 SSRS)