文件共享数据处理扩展插件示例

更新日期: 2005 年 12 月 5 日

FsiDataExtension 是一个用于 Windows 文件系统的简单数据处理扩展插件。它使用 Microsoft .NET Framework 库类 DirectoryInfoFileSystemInfo 来查询任何有效网络文件共享的内容。该示例使用数据处理扩展插件接口以及其他 .NET Framework 类。用于该示例的命名约定为前缀“Fsi”,表示文件共享信息。基于 Itanium 的操作系统不支持该示例。

安装期间不会自动安装 SQL Server 示例。有关如何安装示例的说明,请参阅安装示例

ms160918.note(zh-cn,SQL.90).gif重要提示:
提供的示例仅供教学使用。这些示例不是针对生产环境设计的,也没有在生产环境中进行测试。对于这些示例,Microsoft 不提供相关的技术支持。未经系统管理员许可,不能将示例应用程序和程序集与生产 SQL Server 数据库或报表服务器相连接或一起使用。

要求

您应该熟悉 Microsoft Visual Studio 以及 Microsoft Visual C# 或 Microsoft Visual Basic,并且还应安装以下软件,才能使用 FsiDataExtension 示例:

  • Microsoft Visual Studio 2005 或兼容开发环境(用于查看项目文件)。
  • Microsoft SQL Server 2005,包括 Reporting Services。
  • Microsoft .NET Framework 2.0 版。
  • Reporting Services 示例。在安装 SQL Server 2005 的过程中,可以选择安装示例。对于此版本,选择安装示例时将在您的计算机上安装一个独立的安装程序,通过启动该程序可以提取和安装示例。您可以通过**“开始”**菜单的 Microsoft SQL Server 2005 程序组运行此安装程序。
  • 如果您计划使用示例扩展插件来将其他数据处理功能添加到服务器,还需要安装一个报表服务器,您应具通过网络访问该报表服务器的权限。

位置

此示例位于 Reporting Services 示例目录的 Extension Samples\FsiDataExtension Sample 子目录中。

例如:

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Extension Samples\FindRenderSave Sample

生成示例

使用下列步骤生成示例。

如果尚未创建强名称密钥文件,则请使用以下说明生成该密钥文件。

生成强名称密钥文件

  1. 打开 Microsoft Visual Studio 2005 命令提示符。单击“开始”,依次指向“所有程序”、“Microsoft .NET Framework SDK 2.0”,然后单击“SDK 命令提示符”

    - 或 -

    打开 Microsoft .NET Framework 命令提示符。单击“开始”,依次指向“所有程序”、“Microsoft .NET Framework SDK 2.0”,然后单击“SDK 命令提示符”

  2. 使用更改目录命令 (CD) 将命令提示符窗口的当前目录更改至安装示例的文件夹。

    ms160918.note(zh-cn,SQL.90).gif注意:
    若要确定示例所在的文件夹,请单击“开始”按钮,依次指向“所有程序”、“Microsoft SQL Server”、“文档和教程”,然后单击“示例目录”。如果使用了默认安装位置,则示例将位于 <system_drive>:\Program Files\Microsoft SQL Server\100\Samples 中。
  3. 在命令提示符下,运行以下命令以生成密钥文件:

    sn -k SampleKey.snk

    ms160918.note(zh-cn,SQL.90).gif重要事项:
    有关强名称密钥对的详细信息,请参阅 MSDN 上 .NET 开发中心中的“安全简讯:.NET Framework 中的强名称和安全性”。

使用 .NET Framework SDK 编译示例

  1. 将 Microsoft.ReportingServices.Interfaces.dll 从报表服务器的 \bin 目录复制到示例文件夹下。

  2. 发出以下命令,创建数据处理扩展插件示例 Microsoft.Samples.ReportingServices.FsiDataExtension.dll。

    csc.exe /t:library /out:Microsoft.Samples.ReportingServices.FsiDataExtension.dll *.cs .\properties\*.cs /res:.\properties\Resources.resx  /r:Microsoft.ReportingServices.Interfaces.dll
    

使用 Visual Studio .NET 编译示例

  1. 在 Visual Studio 2005 中打开 FsiDataExtension 解决方案文件(FsiDataExtensionCS.sln 或 FsiDataExtensionVB.sln)。

  2. 在解决方案资源管理器中,选择 FsiDataExtension 项目。

  3. 在**“项目”菜单上,单击“添加引用”**。

    此时,将打开**“添加引用”**对话框。

  4. 单击 .NET 选项卡。

  5. 单击**“浏览”,在本地驱动器上查找 Microsoft.ReportingServices.Interfaces。默认情况下,该程序集位于 ReportServer\bin 目录中。单击“确定”**。

    所选引用将添加到项目中。

  6. 在**“生成”菜单上,单击“生成解决方案”**。

部署示例

在执行完上述步骤后,可以将 Microsoft.Samples.ReportingServices.FsiDataExtension.dll 部署到报表服务器或报表设计器上,供根据自定义数据源运行报表使用。

部署示例

  1. 将 Microsoft.Samples.ReportingServices.FsiDataExtension.dll 复制到报表服务器上。报表服务器扩展插件的默认位置为 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin。

  2. 将程序集复制到报表设计器上。报表设计器扩展插件的默认位置为 C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies。

  3. 将以下项添加到 RSReportServer.config 文件和 RSReportDesigner.config 文件的 Data 元素下(RSReportDesigner.config 文件的默认位置为 C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies,RSReportServer.config 文件的默认位置为 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer):

    <Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>
    
  4. 若要为数据处理扩展插件示例启用通用查询设计器,请将以下项添加到 RSReportDesigner.config 文件的 <Designer> 元素下:

    <Extension Name="FSI" Type="Microsoft.ReportingServices.QueryDesigners.VDTQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
    

有关部署数据处理扩展插件的详细信息,请参阅Deploying a Data Processing Extension

配置示例的代码访问安全性

  1. 打开报表服务器策略配置文件 (rssrvpolicy.config)。此文件的默认位置为 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer。

  2. 必须为数据处理扩展插件授予完全信任。为此,请将以下代码组信息添加到配置文件中代码组部分的末尾:

    <CodeGroup class="UnionCodeGroup"
       version="1"
       PermissionSetName="FullTrust"
       Name="FSICodeGroup"
       Description="Code group for my FSI data processing extension">
          <IMembershipCondition class="UrlMembershipCondition"
             version="1"
             Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
           />
    </CodeGroup>
    
  3. 如果是在报表设计器中使用数据处理扩展插件示例,请使用报表设计器预览策略配置文件 (rspreviewpolicy.config) 和以下代码组重复步骤 1 和步骤 2:

    <CodeGroup class="UnionCodeGroup"
       version="1"
       PermissionSetName="FullTrust"
       Name="FSICodeGroup"
       Description="Code group for my FSI data processing extension">
          <IMembershipCondition class="UrlMembershipCondition"
             version="1"
             Url="C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
           />
    </CodeGroup>
    

    rspreviewpolicy.config 文件的默认位置为 C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies。

    有关 .NET Framework 安全性和 Reporting Services 的详细信息,请参阅Understanding Code Access Security in Reporting Services

创建使用 FsiDataExtension 的报表

本节包含一个快速演练,它显示如何创建使用数据扩展插件示例的示例报表。

ms160918.note(zh-cn,SQL.90).gif注意:
在创建报表之前,您必须先将文件共享数据扩展插件示例部署到报表设计器和报表服务器上。您还必须为扩展插件启用通用查询设计器。有关详细信息,请参阅本主题前面的“部署 FsiDataExtension”。

创建报表项目

  1. 单击**“开始”,依次指向“程序”**和 Microsoft SQL Server 2005,再单击 Business Intelligence Development Studio

  2. 在**“文件”菜单上,指向“新建”,再单击“项目”**。

  3. 在**“项目类型”列表中,单击“商业智能项目”**。

  4. 在**“模板”列表中,单击“报表服务器项目”**。

  5. 在**“名称”**中,键入 FsiReportProject

  6. 单击**“确定”**即可创建该报表项目。

创建报表

  1. 在**“项目”菜单上,单击“添加新项”**。

  2. 在**“类别”列表中,单击“报表项目”**。

  3. 在**“模板”列表中,单击“报表”**。

  4. 在**“名称”框中,键入 FsiReport,再单击“打开”**。

添加使用数据扩展插件示例的数据源

  1. 从“数据”视图的**“数据集”中,选择“<新建数据集...>”**。

    将打开**“数据源”**对话框。

  2. 在**“常规”选项卡上的“名称”**文本框中,键入 FsiDataSource

  3. 在**“类型”列表中,选择“文件共享信息”**。

  4. 将**“连接字符串”**保留为空。数据扩展插件示例不使用连接字符串。

  5. 在**“凭据”选项卡上,单击一种服务器登录类型。您可以为数据扩展插件示例要访问的文件共享输入用户名和密码。单击“使用 Windows 身份验证(集成安全性)”,单击“使用特定用户名和密码”,再输入凭据,或单击“凭据提示”**,再输入提示字符串。

    ms160918.security(zh-cn,SQL.90).gif安全说明:
    请尽可能使用 Windows 身份验证。每当试图访问网络文件共享时,都将提示您输入网络凭据(已缓存凭据的情况例外)。
  6. 单击**“确定”**保存数据源。

查看数据集

  1. 在“数据”视图中,将显示通用查询设计器。从**“命令类型”中,选择“文本”**。

  2. 在通用查询设计器工具栏正下方的查询窗格中,键入网络上可用网络文件共享的路径。例如,可以键入 \\Computer1\Public

  3. 在通用查询设计器的工具栏上,单击**“运行”(!**) 按钮。

    文件共享数据应显示在下面的结果窗格中。

设计报表布局

  1. 在“布局”视图中,单击“工具箱”中的**“表”**。

  2. 将**“表”**控件拖到设计图面上。

  3. 在**“字段”窗口中,将“名称”框拖到“详细信息”**行的第一个单元中。根据需要,将其他字段添加到表中。

预览报表

  1. 单击**“预览”**选项卡来预览报表。根据 FsiDataSource 的凭据设置,可能会要求您输入用户名和密码。

请参阅

任务

编译和运行代码示例
SQL Server Reporting Services 示例

其他资源

扩展插件示例 (Reporting Services)
Implementing a Data Processing Extension

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

发布日期 历史记录

2005 年 12 月 5 日

更改的内容:
  • 更改了有关生成密钥文件的说明,包括密钥文件的名称和位置。