Use Report Controls

• May 31, 2023
• 5 minutes to read

Report controls are basic elements that you can drop onto report bands, bind to data, arrange, and customize to construct a report layout.

Display Text

Label

The XRLabel control displays text (static or retrieved from a data source) in a report.

Use the Text property to specify the label text. Double-click the label to invoke its in-place editor and type the desired text. Press CTRL+Enter to submit text changes and exit the label’s in-place edit mode.

You can use markup in a label caption to change text appearance:

Set the label’s AllowMarkupText property to true to enable this behavior. Refer to AllowMarkupText for more information.

Run Demo: Label Report

Rich Text

The XRRichText control displays HTML or RTF/DOCX formatted content in a report.

Note

Use the XRLabel control for simple formatted text blocks to improve performance and reduce memory consumption.

Run Demo: Rich Text and Mail Merge

Run Demo: PDF Visual Signature

Refer to the Create a Letter in the Visual Studio Report Designer tutorial for information on how to use the XRRichText control to create a letter.

Character Comb

Use the XRCharacterComb control to display each character in an individual cell.

Run Demo: Interactive E-Form

The Create an Interactive E-Form in the Visual Studio Report Designer tutorial describes how to use the XRCharacterComb control to create an interactive e-form.

Barcode

You can use the XRBarcode control to display barcodes in a report.

Run Demo: Barcode Report

Refer to the Use Barcodes article for information on different types of barcodes. See the Create a Swiss QR Bill tutorial for instructions on how to use the QR Code barcode to create a QR Bill.

Display Checkbox

Use the XRCheckBox control to display a checkbox in a report.

Run Demo: Employee Performance Review

Refer to the Create an Interactive Polling tutorial for instructions on how to use the XRCheckBox control to create an interactive polling.

Display Image

The XRPictureBox control embeds pictures into reports.

Run Demo: Shrink and Grow

Display Table

Use the XRTable control to display information in a tabular format.

Run Demo: Table Report

Refer to the Use Tables article for details on how to use tables in reports. See the Create a Table Report in the Visual Studio Report Designer tutorial for instructions on how to use the XRTable control to create a report with a product list.

Visualize Data

Cross Tab

Use the XRCrossTab control to display multi-dimensional data in reports.

Run Demo: Balance Sheet

Run Demo: Sales Summary

The following tutorials contain instructions on how to create cross-tab reports:

• Create a Cross-Tab Report in the Visual Studio Report Designer
• Create a Balance Sheet in the Visual Studio Report Designer

Chart

The XRChart control shows the report’s data as a chart.

Run Demo: Chart Report

Watch Video: Create a Report with Charts to Represent Reporting Data in a Graphical Form

The Use Charts article explains how to use charts in reports. The Create a Report with Charts tutorial contains instructions on how to create a report that displays sales analysis.

Gauge

You can use the XRGauge control to embed gauges into a report.

Sparkline

Use the XRSparkline control to display the report’s data in a compact chart.

Run Demo: Sparkline Report

Watch Video: Sparklines in a Report to Visually Show a Trend and Better Understand Data

Draw Lines and Shapes

Line

Use the XRLine control to separate report sections.

Cross-Band Line and Box

The XRCrossBandLine and XRCrossBandBox controls separate data within multiple bands.

Run Demo: Cross-Band Controls

Shape

You can use the XRShape control to embed simple graphic elements into a report.

Run Demo: Shapes

Display Extra Info

Table of Contents

Use the XRTableOfContents control to display a table of contents in a report.

Run Demo: Fall Catalog

Page Info

The XRPageInfo control displays auxiliary information on report pages.

Sub-report

Use the XRSubreport control to embed the report’s content into another report.

Run Demo: Subreport

Refer to the following tutorials for instructions on how to create reports with subreports:

• Create a Master-Detail Report with a Subreport in the VS Report Designer
• Create a Side-by-Side Report.

PDF Content

Use the XRPdfContent to embed PDF content into a report.

Run Demo: Report Merging With PDF

Refer to the Create a Report Merged with PDF in the Visual Studio Report Designer tutorial for instructions on how create a report with embedded PDF content.

PDF Signature

You can use the XRPdfSignature control to add a visual signature to a report exported to PDF.

Run Demo: PDF Visual Signature

Refer to the following tutorial for information on how to create reports with a PDF signature: Create a Report with a Visual PDF Signature in the Visual Studio Report Designer.

Add Layout Elements

Panel

Use the XRPanel control to create a container for other report controls.

Page Break

The XRPageBreak control inserts a page break in a report document.