如何使用Windows窗体报表查看器与报表服务器
本主题解释如何设置Windows窗体报表查看器以与Telerik报表服务器一起工作
先决条件
已安装并运行Telerik报表服务器R2 2016 (2.1.16.x)及以上版本。
一个有效的(启用的)用户帐户-内置的客人也可以使用用户帐户。
以防你不使用项目模板,添加对本文中列出的所有程序集的引用使用远程报表源的桌面查看器要求.
配置Windows窗体报表查看器以与报表服务器一起工作
要创建表单并在其中驻留报表查看器,您可以使用条目模板,如本文所述如何将报表查看器添加到Windows窗体的。net框架项目,或者通过从工具箱中拖放的方式自己放置。
一旦报表查看器位于表单上,选择它并找到ReportEngineConnection财产。通过按省略号按钮调用UI编辑器。应出现“报表引擎连接编辑器”对话框:
的报告引擎组合框提供以下选项:
嵌入式-报告将在承载查看器的本地机器上处理和呈现。这是为了保持向后兼容性的默认模式。
REST服务-报告将在承载配置和运行REST服务实例的机器上处理。
报表服务器-报告将在承载配置和运行的机器上处理和呈现Telerik报表服务器实例。
选择报表服务器.
在报表服务器URL文本框输入承载报表服务器实例的计算机的地址和端口(如果需要)。
在用户名文本框中输入将用于访问报表的用户帐户,如果要使用内置的客人帐户。
在密码文本框中输入与帐户关联的密码,如果要使用内置的客人帐户。
在文档超时文本框中可以更改呈现文档的超时时间,默认值为100秒。
取消的保持病人存活如果希望客户端会话过期,请选择复选框。
点击好吧当准备好了。对话框将关闭,生成的连接字符串将被填充为ReportEngineConnection财产。
定位ReportSource财产。通过按省略号按钮调用UI编辑器。应出现“报表源编辑器”对话框:
选择报表服务器选择。对话框将尝试使用前面提供的凭据连接到报表服务器实例。如果成功,对话框将填充其类别和报告名称组合框,允许您选择所需的报表。如果报表服务器目前不可用,您仍然可以在组合框中写下类别和报表名称,它们的值将用于为查看器创建报表源。如果需要,您可以使用对话框设置报表源参数,通过按编辑参数按钮。
点击好吧当准备好了。对话框将关闭,生成的报表源将被填充为ReportSource财产。
构建并运行应用程序。如果您的设置配置正确,您应该看到托管在报表服务器实例上的报表显示在WinForms应用程序的报表查看器中。如果没有,请检查故障排除下面的部分。
故障排除
失败的最常见原因与针对报表服务器的身份验证有关。在调查此类问题时,强烈建议使用Fiddler或任何其他web调试器之类的工具。
问题 | 导致 |
---|---|
查看器显示如下消息:注册客户端时出现问题。 |
检查提供的用户名和密码是否有效,以及用户的状态是否为启用在报表服务器中。 |
查看器显示如下消息:系统。OperationCanceledException: {ReportName}报告无法找到 |
确保报告源中指定的URL报告是有效的,并且报表服务器中存在这样的类别和报表。 |
查看器显示如下消息:远程名称无法解析:{服务器名称} |
确保连接字符串中指定的服务器存在,并且具有有效且正在运行的报表服务器实例。 |