WPF开发中Microsoft ReportViewer控件无法使用问题咨询

按以下优先级逐步排查即可解决绝大多数加载、运行异常问题：

• 校验控件版本与项目框架匹配度
  WPF 无原生 ReportViewer 控件，所有实现均通过 WindowsFormsHost 嵌套 WinForm 版本控件实现，版本不匹配是最高发的异常原因：
  • .NET Framework 项目请通过 NuGet 安装正式版 Microsoft.ReportingServices.ReportViewerControl.Winforms 包，不要混用WebForm版本、预览版
  • .NET Core/.NET 5+ 项目请安装适配跨平台框架的 Microsoft.Reporting.NETCore 包
    安装前先卸载项目里所有残留的旧版ReportViewer相关引用，避免版本冲突。
• 校验WinForm承载配置
  1. 项目属性页确认开启Windows窗体支持：.NET Core/.NET 6+项目可直接在csproj文件中添加配置 <UseWindowsForms>true</UseWindowsForms>
  2. XAML页面头部添加控件命名空间声明：xmlns:rv="clr-namespace:Microsoft.Reporting.WinForms;assembly=Microsoft.ReportViewer.WinForms"
  3. 控件必须嵌套在WindowsFormsHost标签内，正确写法参考：

  <WindowsFormsHost>
      <rv:ReportViewer x:Name="reportViewer" />
  </WindowsFormsHost>
  

• 补全运行依赖
  ReportViewer 运行依赖对应版本的 Microsoft System CLR Types for SQL Server，干净环境缺这个组件会直接抛出加载异常：可以直接安装对应版本的系统CLR Types组件，也可以通过NuGet安装Microsoft.SqlServer.Types包随项目一起分发，不需要单独装系统组件。
• 校验平台目标配置
  如果项目固定了x86/x64平台目标，但引用的ReportViewer DLL为相反平台版本，会触发BadImageFormat加载异常。排查时可先将项目平台目标设为Any CPU，取消「首选32位」选项测试，运行正常后再按需匹配对应平台的引用版本。
• 校验本地报表加载配置
  如果是加载本地rdlc报表时触发异常，先将rdlc文件属性设置为复制到输出目录：如果较新则复制，避免运行时找不到文件；同时确认程序运行路径没有UAC权限限制，有权限读取报表文件、访问对应数据源。

内容的提问来源于stack exchange，提问作者dinod tharinda