Blazor Report Viewer Overview

The Blazor Report Viewer is a Bold Reports® reporting component that displays SSRS, RDL, RDLC, and Bold Report Server reports inside Blazor applications. It works as a native Blazor component, so you can drop it into a Blazor Server or Blazor WebAssembly project and render reports without writing custom rendering logic.

This page introduces the Blazor Report Viewer component, its capabilities, and where to go next to add it to your application, configure data sources and parameters, and export report output.

What is the Blazor Report Viewer?

The Blazor Report Viewer is a UI component built on the Blazor component model. It renders reports designed in RDL or RDLC format, and it can connect to reports hosted on SSRS or Bold Report Server, or load report definitions directly without a report server. Because it targets the Blazor component model rather than a JavaScript wrapper, it participates in the same component lifecycle, data binding, and event handling as the rest of your Blazor Server or Blazor WebAssembly application.

The component focuses on report display and interaction. Report authoring is handled separately by the Report Designer component, and the Report Viewer consumes the RDL or RDLC files that a designer produces.

With the Blazor Report Viewer, you can

  • Display RDL, RDLC, SSRS, and Bold Report Server reports inside a Blazor Server or Blazor WebAssembly application.
  • Bind data sources and report parameters at runtime.
  • Render reports with drill-down, drill-through, hyperlinks, and interactive sorting.
  • Export reports to PDF, Excel, CSV, Word, PowerPoint, and HTML.

Key features

Interactive report rendering

  • Drill-down and drill-through navigation.
  • Hyperlink navigation within report content.
  • Interactive column sorting.

Customizable toolbar and elements

  • Customize the toolbar, parameter panel, and report area.
  • Match your application’s layout and branding.

Report processing events

  • Hook into events at each stage of report processing.
  • Customize behavior before rendering or when a report fails to load.

Cross-platform component support

  • Equivalent Report Viewer components exist for jQuery, Angular, React, ASP.NET Core, ASP.NET MVC, ASP.NET Web Forms, WPF, and UWP.
  • Extend the same reporting approach to other parts of your technology stack.

Common use cases

Embedding reports in Blazor line-of-business apps

  • Add the Report Viewer to a Blazor Server or Blazor WebAssembly application.
  • Give business users access to operational and analytical reports inside the app.

Connecting to an existing SSRS or Bold Report Server deployment

  • Point the viewer at reports already hosted on SSRS or Bold Report Server.
  • Reuse existing report catalogs without re-authoring reports for Blazor.

Standalone report viewing without a report server

  • Load RDL or RDLC report definitions directly in the viewer.
  • Skip a centralized report server for smaller or embedded applications.

Exporting reports for offline use or distribution

  • Let users take rendered reports outside the application for sharing or archiving.
  • Support further processing workflows that need a static file.

Who should use this guide?

This guide is intended for:

  • Blazor developers adding report viewing to a Server or WebAssembly application.
  • Developers migrating an existing reporting solution to Blazor.
  • Report authors who need to understand how their RDL or RDLC reports will be displayed.
  • Solution architects evaluating reporting components for a Blazor project.

Prerequisites

Before you begin:

  • A Blazor Server or Blazor WebAssembly application (.NET project) to host the component.
  • A valid Bold Reports® license or trial for the Blazor Report Viewer package.
  • Report definitions in RDL or RDLC format, or access to reports hosted on SSRS or Bold Report Server.

No additional server-side setup is required to view reports locally; connecting to SSRS or Bold Report Server requires the corresponding server configuration described in their respective guides.

Considerations and limitations

  • The Report Viewer displays reports; it does not include report authoring capabilities. Use the Report Designer component to create or edit RDL and RDLC reports.
  • Report rendering performance depends on report complexity, data volume, and the hosting environment (Blazor Server versus Blazor WebAssembly).
  • Some report features may behave differently between Blazor Server and Blazor WebAssembly hosting models due to differences in how each model executes code.

FAQ

Does the Blazor Report Viewer require SSRS or Bold Report Server?

No. You can load RDL or RDLC reports directly in the viewer without a report server, or connect it to SSRS or Bold Report Server when you need centralized report management.

Can I use the Blazor Report Viewer in both Blazor Server and Blazor WebAssembly applications?

Yes. The component supports both Blazor hosting models, so you can use the same reporting approach regardless of which model your application uses.

What report formats can I export from the viewer?

You can export rendered reports to PDF, Excel, CSV, Word, PowerPoint, and HTML.

How do I customize the Report Viewer’s appearance or behavior?

You can customize individual elements of the viewer, such as the toolbar and parameter panel, and use the exposed report processing events to control behavior during rendering.

Is the Blazor Report Viewer available for other platforms besides Blazor?

Yes. Bold Reports® provides equivalent Report Viewer components for jQuery, Angular, React, ASP.NET Core, ASP.NET MVC, ASP.NET Web Forms, WPF, and UWP.

Getting help

If you run into issues while adding or configuring the Blazor Report Viewer, the how-to section covers common integration and troubleshooting topics, and the Bold Reports® support team is available for questions not covered in this documentation.