ComponentOne SSRSDocumentSource for WinForms 入门教程
目录 WinForms 版 ComponentOne SSRSDocumentSource... Error! Bookmark not defined. Winform 版 ComponentOne 工具组件帮助... 1 SSRSDocumentSource 快速入门... 1 在代码中设定网络证书 (Credentials)... 4 在代码中文件位置 (DocumentLocation)... 6 显示文件的状态和页数... 6
ComponentOne SSRSDocumentSource for WinForms ComponentOne SSRSDocumentSource for WinForms 允许你生成分页的 SSRS 报表并能把报 表加载到 C1PrintPreviewControl 中以便查看和导出到各种格式, 如 Adobe PDF, Microsoft Word and Excel C1SsrsDocumentSource 当前版本仅支持 SSRS 报表分页视图 参见 SSRSDocumentSource 快速入门在代码中设定网络证书 (Credentials) 在代码中文件位置 (DocumentLocation) 显示文件的状态和页数 Winform 版 ComponentOne 工具组件帮助 开始 想要获得适用于 WinFroms 的 ComponentOne 工具组件的安装信息, 证书信息, 技术支持, 命名空间以及如何使用控件生成一个程序, 请参阅 Getting Started with Studio for WinForms. 新特性 想要获得适用于 WinFroms 的 ComponentOne 工具组件的最新特性列表, 请参阅 What's Newin Studio for WinForms. SSRSDocumentSource 快速入门 C1SsrsDocumentSource 允许你定义要查看的 SSRS 报表的位置和名称 然后它将启用 C1PrintPreviewControl 控件来显示分页好的 SSRS 报表 它不是一个可视化的控件, 所以它虽然能被加到一个窗体里, 但是它只显示在组件托盘里 注意 : 在开始这个此章节前, 你必须已经访问过 SSRS 报表的服务器端, 并且在服 务器上已经有了至少一个报表 想要创建一个新的 WinForms 应用程序, 使用 C1PrintPreviewControl 控件来预览或者 导出一个 SSRS 报表, 必须使用.NET framework4.0 或者以上版本来完成下面的步骤 : 第 1 页
使用设计器 1. 从工具箱中将 C1SSRSDocumentSource 组件添加到窗体中, 该组件就出现在组件托盘中 如果在工具箱中你无法找到这个组件, 右键点击并选择 Choose items. ChooseToolboxItems 对话框就会出现 该组件就在 C1.Win.C1Document.dll 中, 然后将它添加到工具箱里 2. 添加 C1PrintPreviewControl 控件到窗体中, 并且设置想要的高度和宽度 如果在工具箱中你无法找到这个组件, 右键点击并选择 choose items. Choose Toolbox Items 对话框就会出现 该组件就在 C1.Win.C1Document.dll 中, 然后将它添加到工具箱 里 3. 点击 C1SSRSDocumentSource 组件, 然后点击智能标签来打开 C1SSRSDocumentSource 任务菜单 4. 选中 C1PrintPreviewControl 旁边的复选框, 这样就能将 C1SSRSDocumentSource 组件赋给了 C1PrintPreviewControl 控件的 Document 属性 5. 右键点击 C1SSRSDocumentSource 并且选择 Properties 来打开属性窗口 6. 点击 DocumentLocation 属性旁边的下拉箭头 7. 使用下面的对话框定义 SSRS 服务器端的地址和报表的完整地址, 然后点击 OK 8. 扩展 ConnectionOptions 属性组 9. 点击 Credential 属性旁边的下拉箭头 10. 使用下面的对话框定义用户名, 密码和域名, 然后点击 OK 按钮 第 2 页
注意 : 确认下面的 DLL 添加到了程序的引用中 C1.Win.C1Document.dll C1.Win.dll C1.Win.C1Ssrs.dll C1.Win.C1Report.dll C1.C1Report.dll 你也能够在代码中设定文件位置和网络证书 更多信息请参照在代码中设定文件名和在代码中设置证书 你完成了什么 基于你所看到的在预览控件中定义好的 SSRS 报表, 你也许只需要设定几个参数 第 3 页
你现在可以将它导出成一系列外部程序支持的格式 参见 在代码中设定网络证书 (Credentials) 在代码中设定文件路径 (DocumentLocation) 在代码中设定网络证书 (Credentials) 你能够通过设置 Credentials 属性来定义访问 SSRS 报表所需的用户名和密码 这个属性在在 C1SSRSDocumentSource 中的 SecurityError 事件里 第 4 页
当访问 SSRS 服务器端因为缺少网络证书而被拒绝时, C1SSRSDocumentSource 中的 SecurityError 事件就会被触发, 这样就允许你设定需要的网络证书并重新访问服务器 在设计器中 1. 打开 C1SSRSDocumentSource 中的事件窗口 2. 双击 SecurityError 事件 这样在你的代码中就会产生一个此事件的空的处理块 在代码中 1. 在代码中, 像下面所示修改 c1ssrsdocumentsource1_securityerror 事件处理块 C# private void c1ssrsdocumentsource1_securityerror(object sender, C1.Win.C1Document.SecurityErrorEventArgs e) { var ds = (C1.Win.C1Document.C1SSRSDocumentSource)sender; ds.credential = new System.Net.NetworkCredential("myUserId", "mypassword"); e.retry = true; } VB Private Sub C1SSRSDocumentSource1_SecurityError(sender As Object, e As C1.Win.C1Document.SecurityErrorEventArgs) Handles C1SSRSDocumentSource1.SecurityError Dim ds = DirectCast(sender, C1.Win.C1Document.C1SSRSDocumentSource) ds.credential = New System.Net.NetworkCredential("myUserId", "mypassword") e.retry = True End Sub 2. 在上面的代码中, 用有效的网络证书为 SSRS 报表服务器重新设定了 "myuserid" 和 "mypassword" 当你的窗体加载时,C1SSRSDocumentSource 组件就会尝试访问定义好的报表 第 5 页
注意 : 使用不正确的网络证书会抛出一个安全错误 所以你必须定义一个处理块, 用 该处理块定义正确的网络证书并且重复访问服务器端的操作 3. 运行应用程序 在代码中文件位置 (DocumentLocation) 你可以通过代码在 Form_Load 事件中设定 SSRS 文件的位置 参见 SSRSDocumentSource 快速入门学习如何使用设计器设定文件的位置 在代码中 C# c1ssrsdocumentsource1.documentlocation = new C1.Win.C1Document.SSRSReportLocation("http://ssrs.abc.com/Report Server", "/Adventure Works/Sales"); VB c1ssrsdocumentsource1.documentlocation = New C1.Win.C1Document.SSRSReportLocation("http://ssrs.abc.com/Report Server", "/Adventure Works/Sales") 参见 SSRSDocumentSource 快速入门 显示文件的状态和页数 该章节描述如何使用 C1SsrsDocumentSource 组件的 PageCount 和 State 属性来显示文件源的状态以及已经产生的页数 如快速入门所示的创建一个应用程序然后完成下面几个步骤 第 6 页
在设计器中 1. 在窗体中放置两个 label 2. 设定第一个 label 的 Name 属性为 tbreport 3. 设定第二个 label 的 Name 属性为 tbstate 4. 设定第一个 label 的 Text 属性为 Report:None 这个标签将显示报表的位置 5. 设定第二个 label 的 Text 属性为 State:Unknown 这个标签将显示报表的状态和产生的 页的页数 在代码中 在 Form_Load 的事件中添加下面的代码, 这样就可以将报表的位置, 状态和页数显示在标签上 第 7 页
C# SSRSReportLocation rl = c1ssrsdocumentsource1.documentlocation as SSRSReportLocation; if (rl!= null) tbreport.text = C1.Win.C1Ssrs.ReportSession.Combine(rl.ReportServer, rl.reportpath); else tbreport.text = "None"; switch (c1ssrsdocumentsource1.state) { case C1DocumentSourceState.Generated: case C1DocumentSourceState.GeneratedWithErrors: case C1DocumentSourceState.Generating: tbstate.text = string.format("{0}, Pages: {1}", c1ssrsdocumentsource1.state, c1ssrsdocumentsource1.pagecount); break; default: tbstate.text = c1ssrsdocumentsource1.state.tostring(); break; } 第 8 页
VB Dim rl As SSRSReportLocation = TryCast(c1SSRSDocumentSource1.DocumentLocation, SSRSReportLocation) If rl IsNot Nothing Then tbreport.text = C1.Win.C1Ssrs.ReportSession.Combine(rl.ReportServer, rl.reportpath) Else tbreport.text = "None" End If Select Case c1ssrsdocumentsource1.state Case C1DocumentSourceState.Generated, C1DocumentSourceState.GeneratedWithErrors, C1DocumentSourceState.Generating tbstate.text = String.Format("{0}, Pages: {1}", c1ssrsdocumentsource1.state, c1ssrsdocumentsource1.pagecount) Exit Select Case Else tbstate.text = c1ssrsdocumentsource1.state.tostring() Exit Select End Select 你完成了什么 当运行你的项目时, 注意你放置在窗体上的标签显示了报表的位置, 状态和已经生成的页面的 页数 第 9 页
参见 SSRSDocumentSource 快速入门 第 10 页