共用方式為


編頁報告中的 ReportItems 集合參考 (報表產生器)

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

ReportItems 內建集合是報表項目的文字輸入框集合,例如,編頁報告設計介面上的資料區或文字輸入框列。 ReportItems 集合包含在頁首、頁尾或報表主體目前範圍中的文字方塊。 這個集合是在執行階段由報表處理器和報表轉譯器而決定。 隨著報表處理器連續地將報表資料和報表項目配置元素結合為報表的使用者檢視頁面,目前的範圍也會變更。 您可以使用 ReportItems 內建集合來產生字典樣式的頁首,以在每個頁面上顯示第一個及最後一個項目。

注意

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

使用 ReportItems 值屬性

ReportItems 集合內的項目只有一個屬性:Value。 ReportItems 項目的值可用來顯示或計算報表中其他欄位的資料。 如需存取目前文字輸入框的值,您可以使用 Visual Basic 內建全域 Me.Value,或只使用 Value。 在報表函數 (例如,First 和彙總函式) 中,請使用完整的語法。

例如:

  • 這個置於文字方塊中的運算式會顯示名為 ReportItem Textbox1文字方塊的值:

    =ReportItems!Textbox1.Value

  • 這個放在 ReportItem 文字輸入框 Color 屬性中的運算式,會在值 > 0 時以黑色顯示文字,否則會以紅色顯示值:

    =IIF(Me.Value > 0,"Black","Red")

  • 這個放在頁首或頁尾之文字方塊中的運算式,會為名為 LastName的文字方塊顯示已轉譯報表之每一頁的第一個值:

    =First(ReportItems("LastName").Value)

字典樣式頁首運算式

您可以建立頁首來顯示頁面上的第一個客戶,以及頁面上的最後一個客戶。 因為頁首中的文字方塊在運算式中只能參考 ReportItems 內建集合一次,所以您需要將兩個文字方塊加入到頁首:一個是第一個客戶的名稱 (=First(ReportItems!textboxLastName.Value),另一個則是最後一個客戶的名稱 (=Last(ReportItems!textboxLastName.Value)。

在頁首或頁尾區段中,只有目前頁面上的文字方塊才能作為 ReportItems 集合的成員。 例如,如果 ReportItems!textboxLastName.Value 參考的文字輸入框只會顯示在多頁面資料區的第一個頁面上,則您會看到第一頁的值,但所有其他的頁面都會顯示 [#Error],表示運算式無法評估為已寫入。

ReportItems 集合的範圍

在系統處理報表時,每個報表主體或資料區域中的文字方塊都會在其資料集、資料區域和群組關聯的內容中進行評估。 ReportItems 集合參考的範圍是目前的範圍或高於目前範圍的任何點。

例如,在父群組的資料列內的文字方塊所包含的運算式,不得參考子群組資料列中的文字方塊的名稱。 此類運算式不會解析為報表中的值,因為子資料列文字輸入框超出範圍。 如需詳細資訊,請參閱彙總函式參考 (報表產生器)