發行項
09/24/2010

運算式範例 (Reporting Services)

運算式常用於報表中，以控制內容及報表的外觀。運算式是以 MicrosoftVisual Basic 所撰寫，而且可以使用內建函數、自訂程式碼、全域變數、報表與群組變數，以及使用者定義的變數。

本主題提供可用於報表中一般工作的運算式範例。

Visual Basic 函數：日期、字串、轉換和條件式 Visual Basic 函數的範例。
報表函數：彙總和其他內建報表函數的範例。
報表資料的外觀：變更報表外觀的範例。
屬性：設定報表項目屬性來控制格式或可見性的範例。
參數：在運算式中使用參數的範例。
自訂程式碼：內嵌自訂程式碼的範例。

如需特定用法的運算式範例，請參閱下列主題：

如需有關簡單和複雜運算式、使用運算式的地方，以及您可以包含在運算式中之參考類型的詳細資訊，請參閱＜使用報表運算式＞下的主題。如需有關評估運算式以計算彙總所使用之內容的詳細資訊，請參閱＜計算總計和其他彙總 (Reporting Services)＞。

此外，運算式編輯器包含內建函數的階層式檢視。當您選取函數時，程式碼範例會出現在值窗格中。如需詳細資訊，請參閱＜運算式對話方塊＞。

函數

報表中的許多運算式都有包含函數，您可以使用這些函數來格式化資料、套用邏輯以及存取報表中繼資料。您可撰寫運算式來使用 MicrosoftVisual Basic 執行階段程式庫及 System..::..Convert 和 System..::..Math 命名空間中的函數。您可以加入其他組件或自訂程式碼中函數的參考，您也可以使用 Microsoft.NET Framework 的類別，包括 System.Text.RegularExpressions。如需有關 Visual Basic 函數的詳細資訊，請參閱 msdn.microsoft.com 上的＜Visual Basic 執行階段程式庫＞。

.NET Framework 提供許多方式來指定自訂格式，例如，針對特定的日期格式。如需詳細資訊，請參閱 MSDN 上的＜格式化型別＞。

Visual Basic 函數

您可以利用 Visual Basic 函數來操作文字方塊所顯示的資料，或參數、屬性或報表的其他區域所用的資料。本節提供示範其中一些函數的範例。這些範例指定 Visual Basic 常數做為列舉值，例如 DateInterval.Month。雖然運算式編輯器不支援這些值的 Intellisense，但是它們在運算式中會正確編譯。

如需有關 Visual Basic 函數的詳細資訊，請參閱 Visual Basic 文件集。

日期函數

Today 函數會提供目前的日期。此運算式可用於文字方塊，以顯示報表中的日期，或根據目前的日期在參數中篩選資料。
```
=Today()
```
DateAdd 函數在根據單一參數提供一個範圍的日期時很有用。下列運算式提供在名為 StartDate 之 System..::..DateTime 類型參數的日期六個月之後的日期。
```
=DateAdd(DateInterval.Month, 6, Parameters!StartDate.Value)
```
Year 函數會顯示特定日期的年份。您可以使用這個來將日期群組在一起，或是將年顯示為一組日期的標籤。這個運算式會提供給定訂購日期群組的年份。Month 函數和其他函數也可用來操作日期。如需詳細資訊，請參閱 Visual Basic 文件集。
```
=Year(Fields!OrderDate.Value)
```

字串函數

您可以使用串連運算子和 Visual Basic 常數，將一個以上的欄位結合在一起。下列運算式會傳回兩個欄位，分別位於相同文字方塊中的不同行：
```
=Fields!FirstName.Value & vbCrLf & Fields!LastName.Value 
```
您可以使用 Format 函數，將字串中的日期與數字格式化。下列運算式會以完整日期格式來顯示 StartDate 和 EndDate 參數的值：
```
=Format(Parameters!StartDate.Value, "D") & " through " &  Format(Parameters!EndDate.Value, "D")  
```
如果文字方塊只包含日期或數字，您應該使用文字方塊的 Format 屬性來套用格式，而非使用文字方塊中的 Format 函數。
Right、Len 和 InStr 函數在傳回子字串時很有用，例如，將 DOMAIN\username 修改成只有使用者名稱。下列運算式會從名為 User 的參數傳回字串中反斜線 (\) 字元右邊的字串部分：
```
=Right(Parameters!User.Value, Len(Parameters!User.Value) - InStr(Parameters!User.Value, "\"))
```
下列運算式會產生與上一個運算式相同的值，但它是使用 .NET FrameworkSystem..::..String 類別的成員，而不是 Visual Basic 函數：
```
=Parameters!User.Value.Substring(Parameters!User.Value.IndexOf("\")+1, Parameters!User.Value.Length-Parameters!User.Value.IndexOf("\")-1)
```
顯示多重數值參數中所選的值。下列範例會使用 Join 函數，將選定的 MySelection 參數值串連成單一字串，此字串可以設為報表項目中文字方塊值的運算式：
```
= Join(Parameters!MySelection.Value)
```
.NET FrameworkRegularExpressions 中的 Regex 函數對於變更現有字串的格式 (例如，格式化電話號碼) 很有用處。下列運算式使用 Replace 函數，將欄位中十位數電話號碼的格式從 "nnn-nnn-nnnn" 變更為 "(nnn) nnn-nnnn"：
```
=System.Text.RegularExpressions.Regex.Replace(Fields!Phone.Value, "(\d{3})[ -.]*(\d{3})[ -.]*(\d{4})", "($1) $2-$3")
```
[!附註]

確認 Fields!Phone.Value 的值沒有額外的空格，而且為 System..::..String 類型。

轉換函數

您可以使用 Visual Basic 函數，將欄位從一種資料類型轉換成不同的資料類型。轉換函數可用來將欄位的預設資料類型轉換為計算或結合文字時所需的資料類型。

下列運算式會將常數 500 轉換為 Decimal 類型，以便與篩選運算式之值欄位中的 Transact-SQL money 資料類型相比較。
```
=CDec(500)
```
下列運算式會顯示針對多重數值參數 MySelection 所選的值數目。
```
=CStr(Parameters!MySelection.Count)
```

決策函數

Iif 函數會根據運算式是否評估為 true 而傳回兩個值之一。當 LineTotal 超過 100 時，下列運算式會使用 Iif 函數來傳回布林值 True，否則會傳回 False：
```
=IIF(Fields!LineTotal.Value > 100, True, False)
```
使用多個 IIF 函數 (也稱為「巢狀 IIF」) 可以根據 PctComplete 值傳回三個值之一。您可以將下列運算式置入文字方塊的填滿色彩，依照文字方塊中的值而變更背景色彩。
```
=IIF(Fields!PctComplete.Value >= 10, "Green", IIF(Fields!PctComplete.Value >= 1, "Blue", "Red"))
```
大於或等於 10 的值會以綠色背景顯示、介於 1 和 9 之間的值以藍色背景顯示，小於 1 的值則以紅色背景顯示。
另一種取得相同功能的方法，是使用 Switch 函數。當測試的條件有三個或三個以上時，Switch 函數就很有用。Switch 函數會傳回與數列中評估為 true 的第一個運算式相關聯的值。
```
=Switch(Fields!PctComplete.Value >= 10, "Green", Fields!PctComplete.Value >= 1, "Blue", Fields!PctComplete.Value = 1, "Yellow", Fields!PctComplete.Value <= 0, "Red",)
```
大於或等於 10 的值會以綠色背景顯示、介於 1 和 9 之間的值以藍色背景顯示、等於 1 的值以黃色背景顯示，0 或小於 0 的值則以紅色背景顯示。
第三種取得相同功能的方法，是使用 Choose 函數。Choose 函數會使用第一個參數做為剩餘函數參數中之其中一個參數的索引。第一個參數必須是整數。如果資料表中文字方塊的背景色彩設定為此運算式，MyIndex 的值會控制色彩。
```
=Choose(Fields!MyIndex.Value,"Red","Green","Yellow")
```
例如，當 MyIndex 為 1 時，背景色彩為 "Red"。在查詢結果集中，確認 MyIndex 的資料沒有超過參數清單的範圍。
測試 ImportantDate 欄位的值，如果超過一週會傳回 "Red"，否則傳回 "Blue"。這個運算式可用來控制報表項目中文字方塊的色彩屬性：
```
=IIF(DateDiff("d",Fields!ImportantDate.Value, Now())>7,"Red","Blue")
```
測試 PhoneNumber 欄位的值，如果為 null (在 Visual Basic 中為 Nothing) 傳回 "No Value"，否則傳回電話號碼值。這個運算式可用來控制報表項目中文字方塊的值。
```
=IIF(Fields!PhoneNumber.Value Is Nothing,"No Value",Fields!PhoneNumber.Value)
```
測試 Department 欄位的值，並傳回子報表名稱或null (在 Visual Basic 中為 Nothing)。此運算式可用於條件式鑽研子報表。
```
=IIF(Fields!Department.Value = "Development", "EmployeeReport", Nothing)
```
測試欄位值是否為 Null。此運算式可用來控制影像報表項目的 Hidden 屬性。在下列範例中，只有當欄位 [LargePhoto] 的值不是 Null 時，才會顯示該欄位所指定的影像。
```
=IIF(IsNothing(Fields!LargePhoto.Value),True,False)
```

報表函數

Reporting Services 提供了可用來在報表中操作資料的其他報表函數。此章節提供這些函數的其中兩個範例。如需有關報表函數與範例的詳細資訊，請參閱＜使用運算式中的內建報表和彙總函數 (Reporting Services)＞。

Sum

Sum 函數可以將群組或資料區域中的值加總。群組的頁首或頁尾可以使用這個函數。下列運算式會顯示 Order 群組或資料區域中資料的總和：
```
=Sum(Fields!LineTotal.Value, "Order")
```
您也可以使用 Sum 函數進行條件式彙總計算。例如，如果資料集有稱為 State 的欄位，而該欄位具有 Not Started、Started、Finished 等可能值，則下列運算式在置入群組頁首時，只會計算 Finished 值的彙總總和：
```
=Sum(IIF(Fields!State.Value = "Finished", 1, 0))
```

RowNumber

RowNumber 函數在用於資料區域內的文字方塊時，會為其中顯示此運算式的每個文字方塊執行個體顯示資料列號碼。此函數對於計算資料表中的資料列數目非常有用。它對於更複雜的工作也非常實用，例如，根據資料列數目提供分頁符號。如需詳細資訊，請參閱這個主題中的「分頁符號」。

您所指定的 RowNumber 範圍會控制何時開始重新編號。Nothing 關鍵字指出函數將從最外層資料區域中的第一個資料列開始計數；若要在巢狀資料區域內開始計數，請使用資料區域的名稱。若要在群組內開始計數，請使用群組的名稱。
```
=RowNumber(Nothing)
```

報表資料的外觀

您可以使用運算式來操作報表中資料顯示的方式。例如，可以在單一文字方塊中顯示兩個欄位的值、顯示有關報表的資訊，或影響報表中插入分頁符號的方式。

頁首和頁尾

設計報表時，您需要顯示報表的名稱以及報表尾的頁碼。若要這麼做，您可以使用下列運算式：

下列運算式提供報表的名稱和執行報表的時間。它可以放置在報表尾的文字方塊中或是報表的主體中。時間格式採用 .NET Framework 的簡短日期格式字串：
```
=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
```
下列放在報表尾文字方塊中的運算式，提供報表的頁碼與總頁數。
```
=Globals.PageNumber & " of " & Globals.TotalPages
```

下列範例描述如何顯示一頁中頁首的第一個和最後一個值，與目錄清單中所找到的類似。這個範例假設有個資料區域包含名為 LastName 的文字方塊。

下列運算式放在頁首左側文字方塊中，用來提供頁面 LastName 文字方塊的第一個值：
```
=First(ReportItems("LastName").Value)
```
下列運算式放在頁首右邊的文字方塊中時，會提供此頁上 LastName 文字方塊的最後一個值：
```
=Last(ReportItems("LastName").Value)
```

下列範例描述如何顯示總頁數。這個範例假設包含名稱為 Cost 之文字方塊的資料區域。

下列運算式放在頁首或頁尾中，用來提供頁面 Cost 文字方塊中各個值的總和：
```
=Sum(ReportItems("Cost").Value)
```

[!附註]

在頁首或頁尾中，每個運算式只能參考一個報表項目。此外，您也可以在頁首或頁尾的運算式中參考文字方塊名稱，但不能參考文字方塊內實際的資料運算式。

分頁符號

在某些報表中，除了在群組或報表項目上放置分頁符號以外，您也可能會需要在指定資料列數目的結尾處放置分頁符號。若要執行這個動作，請建立包含所要群組或細節記錄的群組，將分頁符號加入群組中，再依指定的資料列數，將群組運算式加入群組中。

下列運算式放在群組運算式中，每 25 個資料列即指派一個數字。為群組定義分頁符號時，這個運算式每隔 25 個資料列就會產生一個分頁符號。
```
=CInt(Ceiling(RowNumber(Nothing)/25))
```
若要讓使用者設定每頁資料列數的值，請建立名為 RowsPerPage 的參數，然後以該參數做為群組運算式的基礎，如下列運算式所示：
```
=CInt(Ceiling(RowNumber(Nothing)/Parameters!RowsPerPage.Value))
```
如需有關為群組設定分頁符號的詳細資訊，請參閱＜如何：加入分頁符號 (Reporting Services)＞。

屬性

運算式不只用來顯示文字方塊中的資料。運算式也可以用來變更將屬性套用至報表項目的方式。您可以變更報表項目的樣式資訊，或是變更其可見性。

格式化

當用在文字方塊的 Color 屬性時，下列運算式會依 Profit 欄位值而變更文字的色彩：
```
=Iif(Fields!Profit.Value < 0, "Red", "Black")
```
當用在資料區中之報表項目的 BackgroundColor 屬性中時，下列運算式會替代淡綠色和白色之間每個資料列的背景色彩：
```
=Iif(RowNumber(Nothing) Mod 2, "PaleGreen", "White")
```
如果您使用指定之範圍的運算式，可能必須指出彙總函數的資料集：
```
=Iif(RowNumber("Employees") Mod 2, "PaleGreen", "White")
```

[!附註]

可用的色彩是從 .NET FrameworkKnownColor 列舉型別而來。

可見性

您可以使用報表項目的可見性屬性，來顯示和隱藏報表中的項目。在如資料表的資料區域中，您可以根據運算式中的值一開始便隱藏詳細資料列。

當用於群組詳細資料列的初始可見性時，下列運算式會顯示 PctQuota 欄位超出 90% 之所有銷售的詳細資料列：
```
=Iif(Fields!PctQuota.Value>.9, False, True)
```
下列運算式在資料表的 Hidden 屬性中設定時，只有當資料表有 12 個以上的資料列時，才會顯示該資料表：
```
=IIF(CountRows()>12,true,false)
```

URL

您可以使用報表資料來自訂 URL，也可以條件式地控制是否要加入 URL 做為文字方塊的動作。

當下列運算式做為文字方塊的動作時，會產生自訂的 URL，將 EmployeeID 資料集欄位指定為 URL 參數。
```
="http://adventure-works/MyInfo?ID=" & Fields!EmployeeID.Value
```
如需詳細資訊，請參閱＜如何：將超連結加入到 URL (Reporting Services)＞。
下列運算式會條件式地控制是否要在文字方塊中加入 URL。這個運算式會根據名為 IncludeURLs 的參數，讓使用者決定是否要在報表中包含作用中的 URL。這個運算式會設定為文字方塊的動作。透過將參數設定為 False，然後再檢視報表，您可以將報表匯出為沒有超連結的 Microsoft Excel格式。
```
=IIF(Parameters!IncludeURLs.Value,"http://adventure-works.com/productcatalog",Nothing)
```

報表資料

您可以使用運算式來操作用於報表中的資料。您可以參考參數和其他的報表資訊。您甚至可以變更用來擷取報表資料的查詢。

參數

您可以在參數中使用運算式，以更改參數的預設值。例如，您可以利用參數，根據用來執行報表的使用者識別碼來篩選特定使用者的資料。

使用下列運算式做為參數的預設值時，收集執行報表之人員的使用者識別碼：
```
=User!UserID
```
若要在報表的查詢參數、篩選運算式、文字方塊或其他區域中參考參數，請使用 Parameters 全域集合。這個範例假設參數的名稱是 Department：
```
=Parameters!Department.Value
```
您可以在報表中建立參數，但將其設為隱藏。當報表在報表伺服器上執行時，工具列中不會顯示參數，而報表讀取器也無法變更其預設值。您可以使用設為預設值的隱藏參數做為自訂常數。您可以在任何運算式中使用此值，欄位運算式也在內。下列運算式會識別由名為 ParameterField 之參數的預設參數值所指定的欄位。
```
=Fields(Parameters!ParameterField.Value).Value
```
如需詳細資訊，請參閱＜設定已發行報表的參數屬性＞。

自訂程式碼

您可以在報表中使用自訂程式碼，自訂程式碼會內嵌在報表中，或是儲存在用於報表的自訂組件中。如需有關自訂程式碼的詳細資訊，請參閱＜使用運算式中的自訂程式碼參考 (Reporting Services)＞。

下列範例會呼叫將 StandardCost 欄位值轉換成美金值的內嵌程式碼方法 ToUSD：
```
=Code.ToUSD(Fields!StandardCost.Value)
```
下列範例會示範如何定義某些自訂常數和變數。

[Visual Basic]
```
Public Const MyNote = "Authored by Bob"
Public Const NCopies As Int32 = 2
Public Dim  MyVersion As String = "123.456"
Public Dim MyDoubleVersion As Double = 123.456
```
雖然自訂常數和變數不會出現在運算式編輯器的 [常數] 檢視中 (這個檢視只會顯示內建常數)，但是您可以從任何運算式加入參考，如下列範例所示。這些常數和變數會視為 Variant。

[Visual Basic]
```
=Code.MyNote
=Code.NCopies 
=Code.MyVersion
=Code.MyDoubleVersion
```

另一種建立自訂常數或自訂運算式值的方式是使用報表變數或群組變數。

使用群組變數進行自訂彙總

您可以初始化特定群組範圍本機之群組變數的值，然後在運算式中加入該變數的參考。搭配自訂程式碼使用群組變數的其中一種方式是實作自訂彙總。如需詳細資訊，請參閱＜在 Reporting Services 2008 中使用群組變數進行自訂彙總＞(英文)。

如需有關變數的詳細資訊，請參閱＜使用運算式中的報表和群組變數集合參考 (Reporting Services)＞。

在執行階段取代欄位中的文字

下列範例會呼叫內嵌的方法 FixSpelling，此方法會以 "Bicycle" 替代 SubCategory.Value 中出現的所有 "Bike" 文字。

=Code.FixSpelling(Fields!SubCategory.Value)

將下列程式碼內嵌在報表定義後，會顯示 FixSpelling 方法的實作。這個範例會示範如何參考 .NET FrameworkSystem.Text..::..StringBuilder 類別。如需詳細資訊，請參閱＜如何：將程式碼加入至報表 (Reporting Services)＞和＜如何：將組件參考加入至報表 (Reporting Services)＞。

Public Function FixSpelling(ByVal s As String) As String
   Dim strBuilder As New System.Text.StringBuilder(s)
   If s.Contains("Bike") Then
      strBuilder.Replace("Bike", "Bicycle")
      Return strBuilder.ToString()
      Else : Return s
   End If
End Function

在執行階段隱藏 Null 或零值

運算式中有些值可能會在報表處理時評估為 Null 或未定義。這樣可能會造成執行階段錯誤，導致文字方塊中顯示 #Error，而不是評估的運算式。IIF 函數對於這種行為特別敏感，因為不像 If-Then-Else 陳述式，IIF 陳述式的每部分都會先進行評估 (包括函數呼叫)，才會傳遞至測試 true 或 false 的常式。如果 Fields!Sales.Value 為 NOTHING，=IIF(Fields!Sales.Value is NOTHING, 0, Fields!Sales.Value) 陳述式會在轉譯的報表中產生 #Error。

若要避免此種狀況，請使用下列其中一種策略：

如果欄位 B 的值為 0 或未定義，則將分子設為 0，分母設為 1；否則將分子設為欄位 A 的值，分母設為欄位 B 的值。
```
=IIF(Field!B.Value=0, 0, Field!A.Value / IIF(Field!B.Value =0, 1, Field!B.Value))
```

使用自訂程式碼函數來傳回運算式的值。下列範例會傳回目前值和上一個值之間的百分比差異。這可以用來計算兩個連續值之間的差異，也可以處理第一個比較 (沒有上一個值) 的邊緣案例，以及上一個或目前的值為 null (在 Visual Basic 中為 Nothing) 的案例。

Public Function GetDeltaPercentage(ByVal PreviousValue, ByVal CurrentValue) As Object
    If IsNothing(PreviousValue) OR IsNothing(CurrentValue) Then
        Return Nothing
    Else if PreviousValue = 0 OR CurrentValue = 0 Then
        Return Nothing
    Else 
        Return (CurrentValue - PreviousValue) / CurrentValue
    End If
End Function

下列運算式顯示如何從文字方塊呼叫此自訂程式碼：

=Code.GetDeltaPercentage(Previous(Sum(Fields!Sales.Value),"ColumnGroupByYear"), Sum(Fields!Sales.Value))

請參閱

概念

使用運算式中的內建報表和彙總函數 (Reporting Services)

群組運算式的範例 (Reporting Services)

使用運算式 (Reporting Services)

了解運算式參考 (Reporting Services)

變更記錄

更新的內容
已新增 Choose 函數及計算自訂彙總的範例，其方式是搭配自訂程式碼使用群組變數。