VS2017中添加rsweb:ReportViewer时出现歧义错误求助

这个错误的根源很明确：你的项目里重复注册了多个版本的ReportViewer控件，导致编译器不知道rsweb前缀应该对应哪个版本的控件。下面是一步步的解决办法：

1. 清理.aspx页面的重复注册指令 #

打开你的.aspx页面，检查最顶部有没有重复的<%@ Register %>指令。比如如果同时存在两个指向不同版本Microsoft.ReportViewer.WebForms的注册，就会触发歧义。

只保留一个匹配你当前安装包版本的注册，比如（版本号请根据你实际安装的NuGet包调整）：

<%@ Register Assembly="Microsoft.ReportViewer.WebForms, Version=15.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91" Namespace="Microsoft.Reporting.WebForms" TagPrefix="rsweb" %>

2. 检查并修复Web.config中的重复控件注册 #

打开项目根目录的Web.config，找到<pages>下的<controls>节点，看看是不是有多个<add tagPrefix="rsweb" .../>的条目。

删掉多余的，只保留一个正确的注册示例：

<configuration>
  <system.web>
    <pages>
      <controls>
        <!-- 只保留这一条rsweb注册 -->
        <add tagPrefix="rsweb" namespace="Microsoft.Reporting.WebForms" assembly="Microsoft.ReportViewer.WebForms, Version=15.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91" />
      </controls>
    </pages>
  </system.web>
</configuration>

3. 卸载重复的NuGet包 #

打开NuGet包管理器（右键项目→管理NuGet程序包），检查是否同时安装了多个版本的Microsoft.ReportViewer.WebForms或Microsoft.ReportViewer.Common。

卸载掉所有旧版本，只保留一个你需要的版本（建议选最新稳定版），然后点击“还原”并重新生成项目。

4. 清理工具箱中的重复控件 #

从你提供的工具箱截图来看，里面应该存在多个版本的ReportViewer控件，这也是拖拽时自动生成重复注册的原因：

• 右键工具箱空白处，选择“选择项”
• 在弹出的对话框里找到“Microsoft Report Viewer”相关控件，去掉重复版本的勾选，只保留一个对应你NuGet包版本的控件
• 点击确定后，重新从工具箱拖拽ReportViewer到页面，此时生成的代码就不会有歧义了

完成以上步骤后，重新编译运行项目，这个歧义错误应该就能解决了。

内容的提问来源于stack exchange，提问作者M.LOOK