Report Viewer Toolbar does not render properly on IIS 7.0


I was recently working on a reporting web application that uses the Report Viewer ( ReportViewer ) control that ships with SQL Server Reporting Services (SSRS). The Report Viewer control was rendering perfectly when I was developing using Visual Studio 2008. The trouble started when I published the web application to an IIS 7.0 server. The Toolbar was completely broken and showed up something like this.

SSRStoolbar

<rsweb:ReportViewer AsyncRendering="false" ID="reportViewer" Width="100%" Height="100%" runat="server" SizeToReportContent="True" > </rsweb:ReportViewer>

Initially it looked like just the images where missing. But the toolbar was completely broken. The toolbar of the Report Viewer control relies on images and JavaScript that are generated dynamically. It uses a call to the Reserved.ReportViewerWebControl.axd to dynamically generate the images and the JavaScript. Something like

GET /Reserved.ReportViewerWebControl.axd?OpType=Resource&Version=9.0.30729.1&Name=Microsoft.Reporting.WebForms.Icons.NextPage.gif HTTP/1.1

GET /Reserved.ReportViewerWebControl.axd?OpType=Resource&Version=9.0.30729.1&Name=Microsoft.Reporting.WebForms.Icons.LastPage.gif HTTP/1.1

When you use the Report Viewer Control Visual Studio edits your web.config to map a Http Handler to respond to these requests.

<system.web>
  <httpHandlers>
  <add path="Reserved.ReportViewerWebControl.axd" verb="*" type="Microsoft.Reporting.WebForms.HttpHandler, Microsoft.ReportViewer.WebForms, Version=9.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" validate="false"/>
  </httpHandlers>
</system.web>

The above entry tells ASP.NET that whenever a call is made to ReportViewerWebControl.axd use the Microsoft.Reporting.WebForms.HttpHandler assembly to execute it.

This mapping is very important because if you remove it the web server will return a 404 “File Not Found” error code because the ReportViewerWebControl.axd does not exist physically on the server.

Strangely when I checked the IIS 7.0 logs for the broken scenario I found that all requests for ReportViewerWebControl.axd had failed with a 404.

With IIS 7.0 there was an architectural change. There were changes to the web.config structure as well. The <httpHandlers> section that was under the <system.web> has now moved to <handlers> under <system.webServer>

Visual Studio had edited the web.config based on the IIS 6.0 model and had made an entry for the Http Handler under the <httpHandler> section. With IIS 7.0 this section is no longer read. So we need to make the proper entries for the Http Handler that handles the calls to ReportViewerWebControl.axd

<system.webServer>
    <handlers>
    <add name="ReportViewerWebControl" path="Reserved.ReportViewerWebControl.axd" verb="*" type="Microsoft.Reporting.WebForms.HttpHandler, Microsoft.ReportViewer.WebForms, Version=9.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
    </handlers>
</system.webServer>

IIS 7.0 will now understand that whenever a call is made to ReportViewerWebControl.axd it needs to route it to the Http Handler Microsoft.Reporting.WebForms.HttpHandler

Cross posted from Vijay’s Blog ( http://blogs.msdn.com/vijaysk/archive/2009/01/14/report-viewer-toolbar-does-not-render-properly-on-iis-7-0.aspx )

Comments (33)

  1. Mike says:

    We’ve got a box here that chokes on the icons. The box is a win2k3 server and the reportviewer control is 9.  I’ve set the axd app mapping and made sure check file exists is unchecked and it still doesn’t work.  Any ideas?

  2. Andy Potts says:

    Thank you SO much. I’m on the day before a production release and it kept failing on the production server. This solved it.

    Our Pre-Prod environment was IIS7 also, but this error didn’t occur on it. I’ll have to investigate why, but certainly the fix you mentioned above worked for production.

    Thanks again!

  3. Brian Qinn says:

    Vijay,

    The first time I deployed my .NET web app to IIS 7.0 on Vista Home Premium and requested my report I got the report bar but no report results.  I googled the error message and found your post.  BAM! you hit it right on the nose.  Placing the ReportViewerWebControl as an add name in the handlers tag list of the system.WebServer tag in web app WebConfig file worked.  Report displayed as usual with no errors.  Thanks!

  4. carlos says:

    Thanks! This post help me so much!!

  5. Rich Grenwick says:

    Thank you sir!  You really helped me out.

    -Rich

  6. Eric says:

    Thanks, just what I needed! (Except I needed an 8.0.0.0 tag.)

    <add name="ReportViewerWebControl" path="Reserved.ReportViewerWebControl.axd" verb="*" type="Microsoft.Reporting.WebForms.HttpHandler, Microsoft.ReportViewer.WebForms, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>

  7. Amol says:

    Yes no doubt this is a very helpful and good post.

  8. Mithun says:

    Hi,

    How can this help us while viewing the reports thru an application attached to SSL. We are not able to view reports when accessed from https…. Appreciate any help

  9. mahesh says:

    Thank you, I helped me. I was struggling for a week to fix this.

  10. Brenda says:

    THANKS A TON!  My app was working fine without the about until a redirect was involved.  I don’t know what the redirect did to mess it up, but am sure glad this fixed it.  Kudos!

  11. Dev Wesum says:

    Thanks so much.

    This fixed my problem that was a headache for me for many weeks.

  12. Saqib says:

    It worked for me at the time when I was getting out of my mind on how to fix this. Thanks a lot.

  13. Abul Aala Rashad says:

    Thanks a Lot!! it helped me tooo

  14. Tob says:

    You are awesome!!! Saved me so much time, would have never none to do that.

  15. Matias says:

    Thanks!

    From argentina, thanks!

  16. Brian says:

    You the man, this had me beat for hours

  17. Chuck Snyder says:

    My thanks for finding the solution for me also.

    Added the handler and now the images are shown.  Wish MS had automatically added that entry to web.config.

  18. VK says:

    THANK YOU! I have been struggling for past few hours.

  19. GE says:

    thanks a bunch …. informative post !!

  20. Shawn Farmer says:

    I have this same problem except I’m using 2005 and IIS 6

  21. José says:

    Thanks REALLY works for me !!!  

  22. initdotd says:

    AWESOME, thank you! Worked like a charm!

  23. jim b. says:

    great post, saved me a ton of time.!

  24. Dave Wolf at Allergan, Inc. says:

    Thank you. Appears to have solved a problem we've had, too.

  25. hdm says:

    thanks for your help! I have been struggling for two days now and this solved my issue!

  26. Daz says:

    When I added the entry in the web.config file the webserver returned Http500 error, any ideas why anyone 🙂

  27. Eduardo Gurbindo says:

    Wow, you save my life with this problem, I owe you my lilfe.

  28. Bhagabat says:

    Thanks Yaar after two days of struggling now able to solve itr….

  29. Killi says:

    Thanks this post helped me resolving this problem.

  30. Majid Ali says:

    Thanks a lot sir. You realy help me in short time .but this apply only for production server that is windows server 2008 R2.Again thanks

Skip to main content