部署呈现扩展插件

2017-06-13

将 Reporting Services 报表呈现扩展插件编写并编译为 .NET Framework 库后，需要使它可由报表服务器和报表设计器发现。为此，请将扩展复制到相应的目录，并将条目添加到相应的 Reporting Services 配置文件。

配置文件呈现扩展插件元素

将呈现扩展插件编译为.DLL后，即可将条目添加到 rsreportserver.config 文件中。默认情况下，位置 %ProgramFiles%\Microsoft SQL Server\MSRS10_50。<InstanceName>\Reporting Services\ReportServer。父元素为 <Render>。 Render 元素下是每个呈现扩展插件的扩展元素。该 Extension 元素包含两个属性：Name 和 Type。

下表描述了呈现扩展插件元素的属性 Extension ：

特征	DESCRIPTION
名称	扩展的唯一名称。 Name 属性的最大长度是 255 个字符。该名称在配置文件的 Extensions 元素中的所有条目中必须是唯一的。如果存在重复的名称，报表服务器将返回错误。
类型	一个逗号分隔的列表，其中包含完全限定的命名空间以及程序集的名称。
可见	指示呈现扩展插件不应在用户界面中可见的值 `false` 。如果未包含该属性，则默认值为 `true`.
LogAllExecutionRequests	一个值 `false` ，该值指示仅记录会话中第一个报表执行的条目。如果未包含该属性，则默认值为 `true`. 例如，此设置确定是仅记录报表中呈现的第一页的条目（何时 `false`）或报表中呈现的每个页面的条目（时间 `true`）。

有关详细信息，请参阅 RSReportServer Configuration File。

将扩展部署到报表服务器

报表服务器使用呈现扩展插件将报表导出到其他格式。应将呈现扩展插件程序集作为专用程序集部署到报表服务器。还需要在报表服务器配置文件中输入 rsreportserver.config。

部署程序集

将程序集从暂存位置复制到要使用的呈现扩展插件的报表服务器的 bin 目录。报表服务器 Bin 目录的默认位置为 \%ProgramFiles%\Microsoft SQL Server\MSRS10_50。<InstanceName>\Reporting Services\ReportServer\Bin。
复制程序集文件后，打开 rsreportserver.config 文件。 rsreportserver.config 文件也位于报表服务器 bin 目录中。需要在扩展程序集文件的配置文件中创建一个条目。可以使用 Visual Studio 或简单的文本编辑器打开该文件。

有关详细信息，请参阅 RSReportServer Configuration File。
在 Rsreportserver.config 文件中找到 Render 元素。应在以下位置为新创建的扩展创建条目：
```
<Extensions>  
   <Render>  
      <extension configuration>  
   </Render>  
</Extensions>  
```
为呈现扩展插件添加条目。条目应包含一个具有 Name 和 Type 值的元素，可能如下所示：
```
<Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />  
```
Name 的值是呈现扩展插件的唯一名称。 Type 的值是逗号分隔的列表，其中包含实现的完全限定命名空间的IRenderingExtension条目，后跟程序集的名称（不包括 .dll 文件扩展名）。默认情况下，呈现扩展插件可见。若要从用户界面（如报表管理器）隐藏扩展，请将 Visible 属性添加到 Extension 元素，并将其设置为 false。

验证部署

还可以打开报表管理器，并验证扩展是否包含在报表的可用导出类型列表中。

另请参阅

实现呈现扩展插件
 呈现扩展插件概述
 实现 IRenderingExtension 接口
 扩展插件的安全注意事项

通过