在 RSReportServer.Config 中自定义呈现扩展插件参数

2017-03-08

可以在 RSReportServer 配置文件中指定呈现扩展插件参数，以替代在 Reporting Services 报表服务器上运行的报表的默认报表呈现行为。可以修改呈现扩展插件参数以实现以下目标：

更改呈现扩展插件名称在报表工具栏的导出列表中（例如，将“Web 存档”更改为“MHTML”）中的显示方式，或将名称本地化为其他语言。
创建同一呈现扩展插件的多个实例以支持不同的报表呈现选项（例如，图像呈现扩展插件的纵向和横向模式版本）。
将默认呈现扩展插件参数更改为使用不同的值（例如，图像呈现扩展插件使用 TIFF 作为默认输出格式;可以修改扩展参数以改用 EMF）。

更改呈现扩展参数只会影响报表服务器上的呈现操作。不能在报表设计器的报表预览中替代呈现扩展插件设置。

在配置文件中指定呈现扩展插件参数会影响全局呈现扩展插件。每当使用特定的呈现扩展插件时，配置文件中的设置就代替默认值。如果要为特定报表或呈现操作设置呈现扩展参数，必须以编程方式使用 Render 方法指定设备信息或在报表 URL 上指定设备信息设置。有关指定设备信息设置以进行渲染操作的详细信息，以及查看设备信息设置完整列表，请参阅将设备信息设置传递到渲染扩展插件。

查找和修改 RSReportServer.config

报表输出格式的配置在 RSReportServer.config 文件中指定为呈现扩展参数。若要在配置文件中指定呈现扩展插件参数，必须知道如何定义设置呈现参数的 XML 结构。可以修改两个 XML 结构：

该 OverrideNames 元素定义呈现扩展插件的显示名称和语言。
DeviceInfo XML 结构定义呈现扩展插件使用的设备信息设置。大多数呈现扩展插件参数都指定为设备信息设置。

可以使用文本编辑器修改文件。可以在 \Reporting Services\Report Server\Bin 文件夹中找到 RSReportServer.config 文件。有关修改配置文件的详细信息，请参阅修改 Reporting Services 配置文件（RSreportserver.config）。

更改显示名称

呈现扩展插件的显示名称显示在报表工具栏的“导出”列表中。默认显示名称的示例包括 Web 存档、TIFF 文件和 Acrobat （PDF）文件。可以通过在配置文件中指定 OverrideNames 元素，将默认显示名称替换为自定义值。此外，如果要定义单个呈现扩展插件的两个实例，则可以使用该 OverrideNames 元素来区分导出列表中的每个实例。

由于显示名称已本地化，因此如果将默认显示名称替换为自定义值，则必须设置 Language 属性。否则，将忽略指定的任何名称。设置的语言值必须对报表服务器计算机有效。例如，如果报表服务器在法语作系统上运行，则应将“fr-FR”指定为属性值。

以下示例演示如何在英语报表服务器上提供自定义名称：

<Extension Name="XML" Type="Microsoft.ReportingServices.Rendering.DataRenderer.XmlDataReport,Microsoft.ReportingServices.DataRendering">  
   <OverrideNames>  
     <Name Language="en-US">My Custom Display Name for XML Rendering</Name>  
   </OverrideNames>  
</Extension>

更改设备信息设置

若要修改已在报表服务器上部署的呈现扩展插件使用的默认设备信息设置，必须将 XML 结构键入 DeviceInfo 配置文件。每个呈现扩展插件都支持特定于该扩展的设备信息设置。若要查看设备信息设置的完整列表，请参阅将设备信息设置传递到呈现扩展插件。

以下示例演示了修改图像呈现扩展插件默认设置的 XML 结构和语法：

<Render>  
    <Extension Name="IMAGE (EMF)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">Image (EMF)</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <ColorDepth>32</ColorDepth>  
                <DpiX>300</DpiX>  
                <DpiY>300</DpiY>  
                <OutputFormat>EMF</OutputFormat>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>

为呈现扩展插件配置多个条目

可以创建同一呈现扩展插件的多个实例来支持不同的报表呈现选项。定义的每个实例可以具有不同的参数值组合。定义现有呈现扩展的新实例时，请务必执行以下工作：

指定扩展的唯一名称。

每个实例必须具有 Name 属性的唯一值。以下示例使用名称“IMAGE（EMF 横向）”和“IMAGE（EMF 纵向）”来区分这两个版本。

更改已部署的呈现扩展插件的名称时，请谨慎使用。以编程方式指定呈现扩展的开发人员使用扩展名称来识别要用于特定呈现操作的实例。如果在报表服务器上运行自定义 Reporting Services 应用程序，请确保开发人员知道你是否修改了现有扩展名称或添加新扩展名称。
指定唯一的显示名称，以便用户可以了解每个输出格式的差异。

如果要配置同一扩展的多个版本，可以通过为每个版本提供一个值来赋予唯一的名称 OverrideNames。否则，该扩展的所有版本在报表工具栏上的“导出选项”列表中将显示相同的名称。

以下示例演示了如何使用默认图像渲染扩展（生成 TIFF 输出）在纵向模式下输出 EMF，以及如何在第二个实例中以横向模式输出 EMF 格式的报表。请注意，每个扩展名称都是唯一的。测试此示例时，请记住选择不包含交互式功能的报表，例如显示/隐藏选项、矩阵或钻取链接（交互式功能在图像呈现扩展插件中不起作用）：

<Render>  
    <Extension Name="IMAGE (EMF Landscape)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">EMF in Landscape Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>8.5in</PageHeight>  
                <PageWidth>11in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
    <Extension Name="IMAGE (EMF Portrait)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">EMF in Portait Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>11in</PageHeight>  
                <PageWidth>8.5in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>

另请参阅

RSReportServer 配置文件
 RSReportDesigner 配置文件
 CSV 设备信息设置
 Excel 设备信息设置
 HTML 设备信息设置
 图像设备信息设置
 MHTML 设备信息设置
 PDF 设备信息设置
 XML 设备信息设置

通过