A List report item is a data region that visualizes the bound data by producing a series of sections containing data visualizers such as a TextBox or Image arranged in a free-form layout fashion.

Usually, the List is used as a nested data region to display a collection of items within a single data record. For example, the List within Table demo uses the List inside the Products Table to show the price history.

Adding a List

You can add a List into a report by either double-click the corresponding item in the toolbox or drag-and-drop it to the parent container, such as a Table Cell.

List Designer

The List designer determines the content and style of the Section that repeats for each bound data set record that passed through the data set filters and data region filters. For instance, the PriceHistory list in the List within Table contains two textboxes that display the date period and price from ProductListPriceHistories dataset records.

The general list configuration that consists of the the Base Report Item properties and Data Region properties is combined with the Section properties in the Properties panel.

Section Configuration

The Section configuration includes Common Style Properties, Visibility, Page Break, and the following specific properties.

  • The Consume White Space flag indicates whether section instances should eliminate the whitespace if there is more available space than the content takes.
  • The Keep together flag ensures that the section instance always appears on a single page if it fits.

List Grouping

You can group data records within the List so that its section appears once per a grouping value. It could be useful for displaying hierarchical data structures. You can find the example of this approach in the Nested Lists example. The group configuration includes the following properties.

  • The Group Name is the group Id.
  • The Group Expressions is the collection of bound field references or more advanced expressions. Distinct values of group expressions generate grouping values.
  • The Label expression determines the text of a grouping value link in the Report Map. The Nested Lists example uses this property.
  • The Filters Editor allows you to filter out certain grouping values. For example, if we want to exclude the Nintendo publisher from the Nested Lists example output, then we can add the following filter for the Group of the Publishers list.

Group Filter

  • The New Section flag determines whether each grouping value has its page numbering. Check the Global References documentation for more information.