扩展元素
Extensions XML元素指定扩展类型的集合,为其应用配置。
属性和元素
< >扩展
元素
属性 | 此元素没有定义任何属性 |
子元素 | 渲染-指定应用配置设置的渲染扩展的集合。 |
父元素 | Telerik。报告-指定Telerik Reporting配置设置的根元素。Telerik中只能使用一个Extensions元素。报告元素。 |
<渲染>
元素
渲染XML元素指定扩展的集合,为其应用配置。
属性 | 此元素没有定义任何属性 |
子元素 | 扩展-指定应用配置设置的扩展名。Render元素中可以应用多个Extension元素 |
父元素 | 扩展-指定应用配置的扩展类型的集合。在Extensions元素中只能使用一个Render元素。 |
< >扩展
元素
Extension XML元素指定应用配置设置的扩展名。
属性 | 的名字-必需的字符串属性。Name是决定将配置应用到哪个扩展上的关键属性。每个扩展的名称都在扩展的类定义中定义,在ExtensionNameAttribute属性中。所有可用扩展名的列表可以在呈现扩展帮助文章。
|
子元素 | 参数-在extension元素中指定扩展的参数集合。在扩展元素中只能使用一个parameters元素。 |
父元素 | 渲染-指定应用配置的扩展的集合。Render元素中可以应用多个Extension元素。 |
<参数>
元素
Parameters XML元素指定父扩展元素中定义的扩展的参数集合。
属性 | 此元素没有定义任何属性 |
子元素 | 参数-为extension元素中的扩展指定一个参数。在Parameters元素中可以使用多个Parameter元素。 |
父元素 |
|
<参数>
元素
参数XML元素为在祖先extension元素中定义的扩展指定一个参数。参数以名称/值对的形式提供。每个扩展可用的所有参数列表可以在设备信息设置部分。
属性 |
|
子元素 | 此元素没有定义子元素。 |
父元素 | 参数-指定父扩展元素中定义的扩展的参数集合。在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)