使用參數集合參考 (報表產生器 3.0 和 SSRS)

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

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

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

[!附註]

您可以在 Business Intelligence Development Studio 中的報表產生器 3.0 及報表設計師中建立及修改報表定義 (.rdl)。每一個撰寫環境都提供了不同的方式讓您建立、開啟,以及儲存報表和相關的項目。如需詳細資訊,請參閱在報表設計師及報表產生器 3.0 (SSRS) 中設計報表,位於 microsoft.com 網站上。

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

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

範例

說明

=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

會傳回與參數同名之欄位的值。

如需有關在篩選中使用參數的詳細資訊,請參閱<加入資料集篩選、資料區域篩選和群組篩選 (報表產生器 3.0 和 SSRS)>。

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

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

範例

說明

=Parameters!<MultivalueParameterName>.IsMultiValue

傳回 True 或 False。

檢查參數是否為多重值。如果為 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,此值是由多重值參數中以逗號分隔的值清單所組成。您可以在第二個參數中使用任何分隔符號來聯結。

如需有關在篩選中使用參數的詳細資訊,請參閱<參數 (報表產生器 3.0 和 SSRS)>。