使用 SOAP 集成 Reporting Services - Windows 应用程序

  • 项目

可以通过 Reporting Services SOAP API 访问报表服务器的完整功能。 SOAP API 是一个 Web 服务，同样可以轻松地访问此服务以向自定义业务应用程序提供企业报表功能。 只需通过编写对此 Web 服务进行调用的代码，即可在 Windows 应用程序中访问此服务。 通过使用 Microsoft .NET Framework，可以生成一个代理类，该类公开 Web 服务的属性和方法。 然后，可以使用熟悉的基础结构和工具构建基于 Reporting Services 技术构建的业务应用程序。

使用 Windows 窗体 集成报表管理功能

与 URL 访问不同，SOAP API 公开可用于整个报表服务器的一组完整的管理功能。 这意味着，借助于 SOAP，开发人员可以使用报表管理器的完整管理功能。 同样，您可以使用 Windows 窗体开发完整的控制和管理工具。 例如，在 Windows 应用程序中，您可能希望使得用户能够检索报表服务器命名空间的内容。 可以使用 Web 服务 ListChildren 方法列出报表服务器数据库中的所有项，然后使用 Listview、Treeview 或 Combobox 控件向用户显示这些项。 当用户选择窗体上的按钮时，以下 Web 服务代码可用于检索用户的“我的报表”文件夹中可用报表的当前列表：

' Button click event that retrieves a list of reports from  
' the My Reports folder and displays them in a combo box  
Private Sub listReportsButton_Click(sender As Object, e As System.EventArgs)  
   ' Create a new Web service object and set credentials  
   ' to Windows Authentication  
   Dim rs As New ReportingService2010()  
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials  
  
   ' Return the list of items in My Reports  
   Dim items As CatalogItem() = rs.ListChildren("/Adventureworks Sample Reports", False)  
  
   Dim ci As CatalogItem  
   For Each ci In  items  
      ' If the item is a report, add it to   
      ' a combo box  
      If ci.TypeName = "Report" Then  
         catalogComboBox.Items.Add(ci.Name)  
      End If  
   Next ci  
End Sub 'listReportsButton_Click  

// Button click event that retrieves a list of reports from  
// the My Reports folder and displays them in a combo box  
private void listReportsButton_Click(object sender, System.EventArgs e)  
{  
   // Create a new Web service object and set credentials  
   // to Windows Authentication  
   ReportingService2010 rs = new ReportingService2010();  
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  
  
   // Return the list of items in My Reports  
   CatalogItem[] items = rs.ListChildren("/Adventureworks Sample Reports", false);  
  
   foreach (CatalogItem ci in items)  
   {  
      // If the item is a report, add it to   
      // a combo box  
      if (ci.TypeName == "Report")  
         catalogComboBox.Items.Add(ci.Name);  
   }  
}

从此处，您可以让用户通过 Web 浏览器控件或图像控件，从组合框中选择报表并在窗体上预览此报表。

使用Windows 窗体启用报表查看和导航

可以通过两种方法将报表集成到 Windows 窗体应用程序中。

可以使用 SOAP API 通过 Render 方法将报表呈现为所支持的任何呈现格式。 通过 SOAP 启用报表查看和导航也有一些缺点，但这些缺点微不足道：

  • 无法利用通过 URL 访问包含在 HTML 查看器中的报表工具栏的内置功能。

  • 如果您呈现到 HTML，则必须使用 RenderStream 方法将任何图像或资源单独呈现为其他流。

  • 使用 URL 访问通过 SOAP API 呈现报表具有轻微的性能优势。

然而，可以使用 SOAP API 的 Render 方法以编程方式呈现报表并将它们保存为不同的输出格式。 此方法比 URL 访问具有优势，这需要用户交互。 当您使用 SOAP API Render 方法呈现报表时，您可以呈现为所支持的任何输出格式。

还可以使用随 Microsoft Visual Studio 2008 提供的免费分发的报表查看器控件。 通过报表查看器控件，可以轻松地将 Reporting Services 功能嵌入到自定义应用程序中。 报表查看器控件适用于希望作为应用程序功能集的一部分提供预设计、完全创作的报表的开发人员。 例如，网站管理应用程序可能包括在公司网站上显示点击流分析的报告。 在应用程序中嵌入控件为在应用程序部署中包含 Reporting Services 服务器组件提供了简化的替代方法。 这些控件提供报表功能，但没有在 Reporting Services 中找到的额外报表创作、发布或分发和传递支持。

报表查看器控件有两个版本，一个用于各种 Windows 客户端应用程序，另一个用于 ASP.NET 应用程序。 这两个控件都支持本地处理模式和远程处理模式。 在本地处理模式中，应用程序提供报表定义以及数据集报表处理和触发器报表处理。 在远程处理模式中，数据检索和报表处理在报表服务器上进行，而 ReportViewer 控件用于显示和报表导航。 使用此模式可以生成丰富的应用程序，小至桌面应用程序，大到企业级应用程序。

Visual Studio 联机帮助中有关于报表查看器控件的记载。 有关详细信息，请参阅 Visual Studio 产品文档。

相关内容

使用 Web 服务和 .NET Framework 生成应用程序
将 Reporting Services 集成到应用程序中
在 Web 应用程序中使用 SOAP API