ReportViewer 2008 on IIS7(转)

【茶包射手專欄】ReportViewer 2008 on IIS7

 

在測試ReportViewer 2008的過程中，遇到一個問題。

我的作業環境是Windows 2008，用Visual Studio 2008開啟在IIS7上的現有Web Site，新增一個WebForm.aspx，從工具箱拖入ReportViewer，按控件右上角的Report Wizard隨意做了一個ObjectDataSource，一切看來順利得很，但一檢視網頁，噴出一堆Javascript錯誤: (共22個，底下列了幾個)

• RSClientController is not defined
• ReportViewerHoverButton is not defined
• document.getElementById("ReportViewer1_ctl01_ctl01_ctl00_ctl00").Controller is undefined
• document.getElementById("ReportViewer1").ClientController is undefined
• ReportViewerLink is not defined

用Firebug一查，原來網頁中引用很多類似Reserved.ReportViewerWebControl.axd?OpType=Resource&Version=9.0.30729.1&Name=Microsoft.Reporting.WebForms.Scripts.ReportViewer.js的URL，用來載入控件所需的JS、圖檔等等，但全部傳回HTTP 404，以找不到檔案收場，看來是Reserved.ReportViewerWebControl.axd這個HttpHandler沒被正確地註冊所致。

Google到一篇不錯的文章，依著提示摸索一番(但文中"2.Type: Microsoft.Reporting.Microsoft.Reporting.WebForms.HttpHandler, ...."誤寫了多餘的Microsoft.Reporing，應為Microsoft.Reporting.WebForms.HttpHandler才正確，被這個筆誤給攪和了一陣子)，總算把問題解決了。

背後真正的問題是這樣的，Visual Studio 2008在你拖入ReportViewer時會自動在web.config的system.web中加入HttpHandler Mapping:

<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" />

但問題來了，在IIS7上ASP.NET有兩種執行模式，Classic Mode及Integrated Mode，web.config裡HttpHandler等設定也變成有兩區，system.web是給Classic Mode用的，system.webServer是給Integrated Mode用的。

VS2008自動加入HttpHandler設定只改了system.web區(大概是因為IIS7比VS2008晚發展)，卻沒一併在system.webServer區新增設定，而我的WebApp設定是用Integrated Mode執行，這下子等於沒註冊Reserved.ReportViewerWebControl.axd，自然以HTTP 404收場。

前述文章中開啟IIS管理UI加入HttpHandler Mapping的動作，背後便是在system.webServer加入以下的HttpHandler設定:

<add name="Reserved-ReportViewerWebControl-axd" path="Reserved.ReportViewerWebControl.axd" verb="*" type="Microsoft.Reporting.WebForms.HttpHandler, Microsoft.ReportViewer.WebForms, Version=9.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" resourceType="Unspecified" preCondition="integratedMode" />

真相大白了，收隊!