Adding List Data Regions (Visual Studio Report Designer)

A list data region is a data-bound report item that contains a single column of multi-instance data on a report. A list can be used for free-form reports or in conjunction with other data regions. You can define lists that contain any number of report items. A list can be nested within another list to provide multiple groupings of data.

How to Add, Move, and Delete a List

To add a list

  1. Open the client report definition (.rdlc) file in graphical design mode.

  2. In the Toolbox, click List.

  3. On the design surface, drag a box to the size you want the list to be. Alternatively, click the design surface to create a list of fixed size.

After the list is on the report, you can move it by pointing to the shaded border of the list and dragging it to a new location (click anywhere on an empty area to cause the shaded border to appear). To delete a list, right-click any empty space within it and press DELETE.

How to Bind Data to a List

To bind data to a list, drag a field from the Data Sources window onto the list.

Note

If the Data Sources window does not appear, in the Data menu, click Show Data Sources.

Data in a list can be placed into groups and then sorted. For example, you might group products within product categories within departments and then sort the data in ascending order. For more information about grouping and sorting data, see Grouping Data in a Report (Visual Studio Report Designer) and Sorting Data in a Report (Visual Studio Report Designer).

How to Group Data in a List

To add a group to a list

  1. Right-click the list, and then click Properties.

  2. On the General tab, click Edit details group. This opens the Details Grouping dialog box.

  3. On the General tab, do the following:

    • In Name, type the name of the group.

    • In Group on, type or select the expressions by which to group the data.

    • (Optional) In Document map label, type or select an expression to use as a document map label.

    • (Optional) If this group is a recursive hierarchy, for Parent group, type or select an expression to use as the recursive group parent.

    • (Optional) Click Page break at start or Page break at end to place a page break at the beginning or end of each group instance.

  4. (Optional) On the Filters tab, select or type expressions by which to filter the data within the group.

  5. (Optional) On the Visibility tab, select the visibility options for the item. For more information about visibility, see Adding Interactivity, Visibility, and Navigation to a Report (Visual Studio Report Designer).

  6. (Optional) On the Data Output tab, select the data output options for the item, and then click OK.

See Also

Concepts

Adding Data Regions to a Report (Visual Studio Report Designer)
Defining a Report Layout (Visual Studio Report Designer)
Creating Client Report Definition (.rdlc) Files