Click here to Skip to main content
13,403,829 members (50,851 online)
Click here to Skip to main content
Add your own
alternative version


63 bookmarked
Posted 31 Aug 2005

Integrate Reporting Services with VS.NET pages and VS.NET controls

, 31 Aug 2005
Rate this:
Please Sign up or sign in to vote.
Integrate reporting services with VS.NET pages and VS.NET controls.


I'm going very quickly and deeply into the integration of .aspx pages with reporting services reports. If you are new to reporting services this is not an article for you. I will show you how to integrate reports into .aspx pages and alter the content of the reports with web server controls such as drop down boxes and calendars. I take for granted you have a developer machine setup with SQL Server developer edition, Visual Studio .NET, and Reporting Services installed on your client with online samples and books installed as well. I will also not get into designing reports and placing them on your Report Server.

Get Microsoft report viewer

In the samples that are bunged with Microsoft reporting services there is a Report Viewer, this is supplied in VB as well as in C#. I will be concentrating on the C# version. The Report Viewer will allow you to display reports inline with other controls and HTML on a .aspx page.

The report viewer project can be found here:

C:\Program Files\Microsoft SQL Server\MSSQL\Reporting 

You can add this as a sub project to your solution or compile the project to a DLL and add that as a reference to your new reporting project. We will do the latter and add the compiled DLL to our new project.

  1. Open the folder ReportViewer in samples browse to cs (for C# version).
  2. Double click or open the ReportViewer.sln (i.e. open the ReportView solution in Visual Studio).
  3. Build the solution.
  4. Close the project.

Visual Studio has now created a few more directories including a bin directory with a debug version of ReportViewer.dll (you can change the build type to produce a release version if you want).

Configure VS to use Report Viewer

Now you can add ReportViewer.dll to this your web project and view reporting:

  1. Copy the ReportViewer.dll into your bin directory or your web project.
  2. In Solution Explorer: Right-Click references, Add a reference, Projects TAB, browse and select ReportViewer.dll in your bin directory.
  3. Now add a ReportViewer document to the toolbox: Right Click Toolbox, Add Remove Items, Browse to bin directory and select ReportViewer.dll.

You should have ReportViewer on your Toolbox in Visual Studio.

Simple Report Viewer on web pages

This is the real easy bit, drag ReportViewer from the Toolbox onto your webpage:

So, now we have to tell ReportView where to find a report. Right click to see the properties of the ReportViewer:

As can be seen above, I've set ServerUrl and the ReportPath. This will show the report as shown on the default webpage for reporting server except that it's encapsulated into a ASP.NET web page. Unless you specify a report ServerURL and ReportPath the component does not let you alter the size and height of the report on the web page.

Useful parameters

  • ServerUrl: The website server of your MS Reporting Server is installed.
  • ReportPath: The path on the Reporting Server with the report name (Folder/report name).
  • ToolBar: Turn the toolbar on or off, good for exporting to Excel, PDF etc.
  • Parameters: Show parameter fields to the user (i.e. input fields that drive the report data).
  • Zoom: Handy for printing directly from the web pages.

Top Tip: Store the ServerURL in web.config application key so that it can be used throughout your application. System administrators have a habit of changing the backend servers.


    <add key="Key_ReportServer" 


C# code

private void Page_Load(object sender, System.EventArgs e)
    // Put user code to initialize the page here

    ReportViewer1.ServerUrl  = 

Build a parameter report

Some reports take parameters and you detail what information is to be displayed by the start date, year, end date etc. I generally use SQL Server stored procedures to drive reports as I can change the backend SQL logic without the hassle of uploading and changing the report.

Below is a very simple stored procedure used to get the Order Qty (number of orders) over a set year. The SQL is included for reference:

@Year as int
select * from Ord_Qty
Where YearInt = @Year

I have put this in a simple report that displays a table by Month and Year with a Qty value. I also placed a chart on the report to show the quantity of sales by month. I have uploaded Report5.rdl to my Reporting Services server called in a test directory. Note that when the report is created by using the above stored procedure it will pull the parameter @Year as a report parameter automatically.

There are two ways I could view the report on the web page: Enter report details into parameters as shown above or use the code to tell the ReportViewer component where to find the report. Since we're all programmers I will use the code.

Change the report with the code

ReportViewer1.ServerUrl = 
ReportViewer1.ReportPath = "/test/Report5";

Specify the Parameters of the Report component what the ServerUrl and the ReportPath are and the report will appear on the screen on build on browse. You still have to enter a year into the Parameter field just like going to reporting services directly; which is a bit crude for users, the toolbar is visible we will turn those off so that they are hidden from the user.

ReportViewer1.Toolbar = 
ReportViewer1.Parameters = 

Top Tip: You have a single ReportViewer component that can be used to display more than one report.

Integrating web components

By placing a drop down list onto the web page and setting three variables (2002, 2003, 2004) we can use this to drive the Report parameter. You will have to ensure that autopostback is enabled on the drop list control.

private void DropDownList1_SelectedIndexChanged(object sender, 
                                             System.EventArgs e)
   string param = "&Year=" + DropDownList1.SelectedValue;
   ReportViewer1.ReportPath = "/test/Report5" + param ;  

A more complex example is here pulling the date info from a calendar control and a drop down:

string ReportPath = "/Reports/Invoice";
string param = "&Year=" + yearint + "&Month=" + monthint 
                              + "&Day=" + dayint + 
                              "&Cust=" Drop_Cust.SelectedValue;
ReportViewer1.ReportPath = ReportPath + param ;

Turning on toggle toolbar

You can also place a web control button on your page to toggle the toolbar on and off.

private void Button1_Click(object sender, System.EventArgs e)
    ReportViewer1.Toolbar = 

Page view

Complete code

using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Web;
using System.Web.SessionState;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;
using System.Configuration;

namespace ReportWeb
    /// <summary>
    /// Summary description for WebForm1.
    /// </summary>
    public class WebForm1 : System.Web.UI.Page
        protected System.Web.UI.WebControls.DropDownList DropDownList1;
        protected System.Web.UI.WebControls.Button Button1;
        protected Microsoft.Samples.ReportingServices.ReportViewer ReportViewer1;
        private void Page_Load(object sender, System.EventArgs e)
            // Put user code to initialize the page here
            if (!IsPostBack)
              string param = "&Year=" + DropDownList1.SelectedValue;
              ReportViewer1.ReportPath = "/test/Report5" + param ;
              ReportViewer1.ServerUrl = 
              ReportViewer1.Toolbar = 
              ReportViewer1.Parameters = 
        #region Web Form Designer generated code
        override protected void OnInit(EventArgs e)
            // CODEGEN: This call is required by the ASP.NET Web Form Designer.
        /// <summary>
        /// Required method for Designer support - do not modify
        /// the contents of this method with the code editor.
        /// </summary>
        private void InitializeComponent()
            this.DropDownList1.SelectedIndexChanged += 
                new System.EventHandler(this.DropDownList1_SelectedIndexChanged);
            this.Button1.Click += new System.EventHandler(this.Button1_Click);
            this.Load += new System.EventHandler(this.Page_Load);
        private void DropDownList1_SelectedIndexChanged(object sender, 
                                                           System.EventArgs e)
            string param = "&Year=" + DropDownList1.SelectedValue;
            ReportViewer1.ReportPath = "/test/Report5" + param ;
        private void Button1_Click(object sender, System.EventArgs e)
            ReportViewer1.Toolbar = 


  • V1.0 - Initial release.


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Frank Kerrigan
Software Developer (Senior)
United Kingdom United Kingdom
Frank Kerrigan

Currently developing Insurance systems with SQL Server, ASP.NET, C#, ADO for a company in Glasgow Scotland. Very keen on OOP and NUNIT testing. Been in IT forever (20 years) in mix of development and supporting applications / servers. Worked for companies big and small and enjoyed both.

Developed in (newest first) : C#, Progress 4GL, ASP.NET, SQL TSQL, HTML, VB.NET, ASP, VB, VBscript, JavaScript, Oracle PSQL, perl, Access v1-2000, sybase/informi, Pic Controllers, 6502 (ask your dad).

Msc .Net Development Evenings
MCAD Passed
MCP C# ASP.NET Web Applications
MCP SQL Server 2000
HND Computing
OND / HNC Electrical Engineering,

You may also be interested in...


Comments and Discussions

Questionmissing reportviewer project and dll [modified] Pin
jivangilad@yahoo.com28-Nov-06 23:56
memberjivangilad@yahoo.com28-Nov-06 23:56 
AnswerRe: missing reportviewer project and dll Pin
Frank Kerrigan30-Nov-06 9:39
memberFrank Kerrigan30-Nov-06 9:39 
GeneralThe stored procedure parameters Pin
sergio_m9911-Jul-06 8:21
membersergio_m9911-Jul-06 8:21 
GeneralReportViewer component is disabled!!!!! Pin
ersinsivaz14-Jun-06 22:59
memberersinsivaz14-Jun-06 22:59 
GeneralRe: ReportViewer component is disabled!!!!! Pin
Frank Kerrigan15-Jun-06 7:51
memberFrank Kerrigan15-Jun-06 7:51 
GeneralInserting Image in my Report (ReportViewer) Pin
d00_ape23-May-06 5:52
memberd00_ape23-May-06 5:52 
GeneralChart Pin
Tuaregue11-May-06 1:59
memberTuaregue11-May-06 1:59 
GeneralRe: Chart Pin
Frank Kerrigan11-May-06 13:53
memberFrank Kerrigan11-May-06 13:53 
GeneralI dont have reportviewer.dll Pin
osmanayhan24-Apr-06 4:40
memberosmanayhan24-Apr-06 4:40 
GeneralRe: I dont have reportviewer.dll Pin
Frank Kerrigan24-Apr-06 8:56
memberFrank Kerrigan24-Apr-06 8:56 
GeneralRe: I dont have reportviewer.dll Pin
osmanayhan25-Apr-06 6:56
memberosmanayhan25-Apr-06 6:56 
GeneralRe: I dont have reportviewer.dll Pin
Andrew D. Bryan27-Apr-06 6:53
memberAndrew D. Bryan27-Apr-06 6:53 
GeneralRe: I dont have reportviewer.dll Pin
osmanayhan27-Apr-06 20:57
memberosmanayhan27-Apr-06 20:57 
GeneralRe: I dont have reportviewer.dll Pin
osmanayhan27-Apr-06 21:54
memberosmanayhan27-Apr-06 21:54 
GeneralIntegrate reporting services with VS.NET pages and VS.NET controls Pin
adb96hxo15-Mar-06 23:38
memberadb96hxo15-Mar-06 23:38 
GeneralRe: Integrate reporting services with VS.NET pages and VS.NET controls Pin
Frank Kerrigan16-Mar-06 13:22
memberFrank Kerrigan16-Mar-06 13:22 
ASPNET user is the default user that runs ASP server process. Ensure you have Anonynous (forgive my spelling) turned off for the "reportserver" virtual directory. This is the one you want to give out to your users / place on ASP.NET pages.


Try and browse to the report via the reportserver virtual directory to see if you can see it from other machines.

You also might have to look at permissions on your SQL server connection and set this to a SQL user rather than a username password supplied by the client. I've had issues with dialup user / vpn users not suppling correct Kerboros authenication for reports embeded in sharepiont webpars.

If your intranet is a wan you can have issues with Kerboros through firewalls / routers.

Hope this is of somehelp

GeneralRe: Integrate reporting services with VS.NET pages and VS.NET controls Pin
adb96hxo17-Mar-06 3:59
memberadb96hxo17-Mar-06 3:59 
GeneralRe: Integrate reporting services with VS.NET pages and VS.NET controls Pin
Frank Kerrigan21-Mar-06 0:37
memberFrank Kerrigan21-Mar-06 0:37 
GeneralRe: Integrate reporting services with VS.NET pages and VS.NET controls Pin
Arina200531-Mar-06 11:23
memberArina200531-Mar-06 11:23 
GeneralLimitation of Reporting Services Pin
Gaurang Desai31-Aug-05 21:43
memberGaurang Desai31-Aug-05 21:43 
GeneralRe: Limitation of Reporting Services Pin
Frank Kerrigan31-Aug-05 23:00
memberFrank Kerrigan31-Aug-05 23:00 
GeneralRe: Limitation of Reporting Services Pin
reklats7-Sep-05 4:58
sussreklats7-Sep-05 4:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.1802120.2 | Last Updated 31 Aug 2005
Article Copyright 2005 by Frank Kerrigan
Everything else Copyright © CodeProject, 1999-2018
Layout: fixed | fluid