Telerik报告?下载30天免费试用

扩展元素

Extensions XML元素指定扩展类型的集合,为其应用配置。

属性和元素

< >扩展元素

属性 此元素没有定义任何属性
子元素 渲染-指定应用配置设置的渲染扩展的集合。
父元素 Telerik。报告-指定Telerik Reporting配置设置的根元素。Telerik中只能使用一个Extensions元素。报告元素。

<渲染>元素

渲染XML元素指定扩展的集合,为其应用配置。

属性 此元素没有定义任何属性
子元素 扩展-指定应用配置设置的扩展名。Render元素中可以应用多个Extension元素
父元素 扩展-指定应用配置的扩展类型的集合。在Extensions元素中只能使用一个Render元素。

< >扩展元素

Extension XML元素指定应用配置设置的扩展名。

属性 的名字-必需的字符串属性。Name是决定将配置应用到哪个扩展上的关键属性。每个扩展的名称都在扩展的类定义中定义,在ExtensionNameAttribute属性中。所有可用扩展名的列表可以在呈现扩展帮助文章。
  • 类型-可选string属性。当添加新的扩展或核心时使用它
    扩展被新扩展覆盖。指定扩展时要使用的扩展类的名称
    中指定的名称的名字属性是必需的。请使用以下格式:
    type="*完全限定类名*,*程序集文件名*,*版本*,*文化*,*公钥令牌*"
    例如:type = " MyAssembly。MyExtension, MyAssembly, Version=1.0.0.0, Culture=neutral,PublicKeyToken=null"
  • 描述-可选string属性。为扩展定义描述。它是
    用于覆盖扩展的默认描述。报告引擎在某些地方使用描述
    这里列出了扩展名。例如,在Win和Web ReportViewer控件中,描述被用作
    带有可用导出格式的下拉列表中的标签。每个扩展的描述信息缺省值为
    在扩展的类定义中定义,通过exptansiondescriptionattribute属性。
  • 可见—可选布尔属性(有效值为可见= " true "可见= " false ").
    该值用于确定是否必须将扩展填充到可用扩展列表中。默认的
    价值是真实的。您可以使用它从可用呈现扩展的列表中隐藏导出格式。
  • 订单—可选的整数属性。该值用于对可用扩展列表中的扩展进行排序。您可以使用它在查看器格式下拉菜单中对扩展进行排序。例如,如果您将DOCX呈现扩展的顺序值设置为1,它将列在呈现扩展列表的第一个。如果两个扩展具有相同的订单号,则按其描述(升序)排序。默认情况下,所有扩展的顺序值都为int。MaxValue
子元素 参数-在extension元素中指定扩展的参数集合。在扩展元素中只能使用一个parameters元素。
父元素 渲染-指定应用配置的扩展的集合。Render元素中可以应用多个Extension元素。

<参数>元素

Parameters XML元素指定父扩展元素中定义的扩展的参数集合。

属性 此元素没有定义任何属性
子元素 参数-为extension元素中的扩展指定一个参数。在Parameters元素中可以使用多个Parameter元素。
父元素
  • 扩展-指定应用该配置的扩展名。Extension元素中只能应用一个Parameters元素。缺省值为true。您可以使用它从可用呈现扩展的列表中隐藏导出格式。
  • 提供者-指定要在应用程序中注册的缓存提供程序。

<参数>元素

参数XML元素为在祖先extension元素中定义的扩展指定一个参数。参数以名称/值对的形式提供。每个扩展可用的所有参数列表可以在设备信息设置部分。

属性
  • 的名字-提供的参数的名称。所需的属性。
  • 价值-带有指定名称的参数值。因为该值只能是a字符串,参数Type必须有associatedTypeConverter处理从字符串.内置的。net值类型和枚举定义了类型转换器。
子元素 此元素没有定义子元素。
父元素 参数-指定父扩展元素中定义的扩展的参数集合。在parameters元素中可以使用多个参数元素。

例子

基于xml的配置文件

<配置>…< >扩展<渲染>    

基于json的配置文件:

"telerikReporting": {"extensions": [{"name": "PDF", "description": "PDF description", "parameters": [{"name": "DocumentAuthor", "Value": "John Doe"}]}]}

为渲染扩展配置多个表项

您可以指定单个呈现扩展的多个实例来改变呈现行为。如果配置多个实例,请确保每个扩展的名字是独一无二的。然后,您可以通过使用扩展名来标识用于特定呈现操作的特定实例,从而以编程方式使用呈现扩展。

您还应该指定描述扩展元素的属性。指定的字符串描述将在报表的导出选项列表中对用户可见。如果您正在配置同一扩展的多个版本,请确保为描述.否则,扩展的所有版本将具有相同的导出选项名称。

下面的示例说明了如何使用默认的图像呈现扩展(它产生TIFF输出)以及在EMF中输出报告的第二个实例。注意,扩展名将一个实例与另一个实例区分开来:

基于xml的配置文件

< Telerik。报告> <扩展> <渲染> <扩展名称="TIFF_CCITT4"类型="Telerik.Reporting.ImageRendering. "ImageReport Telerik。报告, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be" description="TIFF file (CCITT Group 4)">       

基于json的配置文件:

"telerikReporting": {"extensions": [{"name": "TIFF_CCITT4", "type": "telerikReporting . imagerendering . "ImageReport Telerik。报告, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be" "description": "TIFF file (CCITT Group 4)", "parameters": [ { "Name": "TiffCompression", "Value": "ccitt4" } ] } ] }

代码示例中列出的版本为version =x.x.x。X,在继续之前,您应该使用您使用的确切的程序集版本来更改它。

以编程方式设置呈现参数

要以编程方式定义设备呈现参数,我们需要一个键/值对,还有什么比一个哈希表表示键/值对的集合。如果集合包含指定的呈现扩展不支持的呈现参数,则将忽略它们。

Telerik.Reporting.Processing.ReportProcessor reportProcessor = new Telerik.Reporting.Processing.ReportProcessor();System.Collections.Hashtable deviceInfo = new System.Collections.Hashtable();deviceInfo。Add("DocumentAuthor", "John Doe");deviceInfo。添加("DocumentTitle", "我的文档标题");Telerik.Reporting.TypeReportSource = new Telerik.Reporting.TypeReportSource();// reportName是报告typeReportSource的程序集限定名。TypeName = reportName;Telerik.Reporting.Processing.RenderingResult result = reportProcessor。RenderReport("PDF", typeeportsource, deviceInfo);
将reportProcessor设为新的Telerik.Reporting.Processing.ReportProcessor()将deviceInfo设为新的System.Collections.Hashtable() deviceInfo。添加("DocumentAuthor", "John Doe") deviceInfo。Add("DocumentTitle", "My Doc title") Dim typeReportSource As New Telerik.Reporting.TypeReportSource()' reportName是报告typeReportSource的程序集限定名。由于Telerik.Reporting.Processing.RenderingResult = reportProcessor. TypeName = reportName暗淡结果。渲染报告("PDF", typeeportsource, deviceInfo)
在本文中
Baidu
map