編頁報告中的運算式 (報表產生器)

發行項
05/04/2023

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

編頁報告廣泛使用運算式來擷取、計算、顯示、分組、排序、篩選、參數化及格式化資料。

許多報表項目屬性都可以設定為運算式。運算式可協助您控制報表的內容、設計與互動性。運算式都是以 Microsoft Visual Basic 撰寫，儲存在報表定義中，並會在您執行報表時由報表處理器評估。

報表不像 Microsoft Office Excel 等應用程式，可讓您直接在工作表中使用資料，而是要使用作為資料預留位置的運算式。若要從評估的運算式查看實際資料，您必須預覽報表。當您執行報表時，報表處理器會評估每個運算式，因為它會結合資料與報表配置元素，例如資料表和圖表。

當您設計報表時，系統會為您設定許多報表項目的運算式。例如，當您將欄位從資料窗格拖曳到報表設計介面上的資料表資料格時，文字方塊值會設定為欄位的簡單運算式。在下圖中，[報表資料] 窗格會顯示 ID、Name、SalesTerritory、Code 和 Sales 資料集欄位。有三個欄位已加入資料表中：[Name]、[Code] 和 [Sales]。設計介面上的標記 [Name] 代表基礎運算式 =Fields!Name.Value。

rs_DataDesignandPreview

當您預覽報表時，報表處理器會結合資料表資料區與資料連接中的實際資料，並針對結果集中的每個資料列顯示資料表中的資料列。

若要手動輸入運算式，請在設計介面上選取項目，然後使用快速鍵功能表和對話方塊來設定此項目的屬性。當您在下拉式清單中看到 [(fx)] 按鈕或 <Expression> 值時，就知道可以將此屬性設定為運算式。如需詳細資訊，請參閱新增運算式 (報表產生器和 SSRS)。

若要開發複雜運算式或使用自訂程式碼或自訂組件的運算式，建議您使用 SQL Server Data Tools (SSDT) 中的報表設計師。如需詳細資訊，請參閱報表設計師中運算式的自訂程式碼及組件參考 (SSRS)。

注意

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

了解簡單和複雜運算式

運算式會以等號 (=) 開頭，並以 Microsoft Visual Basic 撰寫。運算式可以包含常數、運算子及內建值 (欄位、集合和函數) 和外部或自訂程式碼參考的組合。

您可以使用運算式來指定許多報表項目屬性的值。最常見的屬性為文字方塊與預留位置文字的值。如果文字方塊只包含一個運算式，該運算式通常就是文字方塊屬性的值。如果文字方塊包含多個運算式，每個運算式都是文字方塊中的預留位置文字值。

根據預設，運算式在報表設計介面上會顯示成「簡單運算式」或「複雜運算式」。

簡單：簡單運算式包含內建集合中單一項目的參考，例如資料集欄位、參數或內建欄位。在設計介面上，簡單運算式會以方括號的形式出現。例如， [FieldName] 相當於基礎運算式 =Fields!FieldName.Value。當您建立報表配置，並將項目從 [報表資料] 窗格拖曳到設計介面時，系統會為您自動建立簡單運算式。如需代表不同內建集合之符號的詳細資訊，請參閱了解簡單運算式中的字首符號。
複雜：複雜運算式包含多個內建參考、運算子和函數呼叫的參考。當運算式值包含多個簡單參考時，複雜運算式會以 <<Expr>> 的形式出現。若要檢視運算式，請將滑鼠指標停留在該運算式上，然後使用工具提示。若要編輯運算式，在 [運算式] 對話方塊中開啟該運算式。

下圖同時針對文字方塊和預留位置文字顯示一般的簡單運算式和複雜運算式。

rs_ExpressionDefaultFormat

若要顯示範例值而非運算式的文字，請將格式套用到文字方塊或預留位置文字。下圖顯示切換為顯示範例值的報表設計介面：

rs_ExpressionSampleValuesFormat

如需詳細資訊，請參閱格式化文字和預留位置 (報表產生器和 SSRS)。

了解簡單運算式中的字首符號

簡單運算式會使用符號來指示參考是指向欄位、參數、內建集合還是報表項目集合。下表顯示了顯示和運算式文字的範例：

Item	顯示文字範例	運算式文字範例
資料集欄位	`[Sales]` `[SUM(Sales)]` `[FIRST(Store)]`	`=Fields!Sales.Value` `=Sum(Fields!Sales.Value)` `=First(Fields!Store.Value)`
報表參數	`[@Param]` `[@Param.Label]`	`=Parameters!Param.Value` `=Parameters!Param.Label`
內建欄位	`[&ReportName]`	`=Globals!ReportName.Value`
用於顯示文字的常值字元	`\[Sales\]`	`[Sales]`

撰寫複雜運算式

運算式可以包含函數、運算子、常數、欄位、參數、內建集合的項目，以及內嵌自訂程式碼或自訂組件的參考。

注意

下表列出可以包含在運算式中的參考種類：

參考	說明	範例
常數	描述可透過互動方式針對需要常數值的屬性而存取的常數，例如字型色彩。	`="Blue"`
運算子	描述您可以用來結合運算式中參考的運算子。例如，&運算子用於串連字串。	`="The report ran at: " & Globals!ExecutionTime & "."`
內建集合	描述可以包含在運算式中的內建集合，例如， `Fields`、 `Parameters`和 `Variables`。	`=Fields!Sales.Value` `=Parameters!Store.Value` `=Variables!MyCalculation.Value`
內建報表和彙總函式	描述可以從運算式存取的內建函數，例如， `Sum` 或 `Previous`。	`=Previous(Sum(Fields!Sales.Value))`
報表產生器中運算式的自訂程式碼及組件參考 (SSRS)	描述如何存取內建 CLR 類別 Math 和 Convert、其它 CLR 類別、Visual Basic 執行階段程式庫函式，或是來自外部組件的方法。描述如何存取內嵌於報表，或在編譯後安裝在報表用戶端和報表伺服器上做為自訂組件的自訂程式碼。	`=Sum(Fields!Sales.Value)` `=CDate(Fields!SalesDate.Value)` `=DateAdd("d",3,Fields!BirthDate.Value)` `=Code.ToUSD(Fields!StandardCost.Value)`

驗證運算式

為特定的報表項目屬性建立運算式時，包含在運算式中的參考取決於報表項目屬性可以接受的值，以及評估屬性的範圍。例如：

根據預設，運算式 [Sum] 會計算評估運算式時範圍內資料的總和。若是資料表資料格，範圍則視資料列和資料行群組成員資格而定。如需詳細資訊，請參閱總計、彙總與內建集合的運算式範圍 (報表產生器和 SSRS)。
若是 Font 屬性的值，此值必須評估為字型的名稱。
運算式語法是在設計階段進行驗證。當您發行報表時，便會驗證運算式範圍。若是與實際資料相關的驗證，則只能在執行階段偵測錯誤。其中部分運算式在轉譯的報表中會產生 #Error 做為錯誤訊息。您必須使用 SQL Server Data Tools (SSDT) 中的報表設計師，以利判斷此種錯誤的問題。報表設計師提供的 [輸出] 視窗可提供有關這些錯誤的詳細資訊。

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