ReportExecutionService.Render2 方法

定义

命名空间:: ReportExecution2005

程序集:: ReportExecution2005.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

处理特定报表并以指定格式渲染。

public:
 cli::array <System::Byte> ^ Render2(System::String ^ Format, System::String ^ DeviceInfo, ReportExecution2005::PageCountMode PaginationMode, [Runtime::InteropServices::Out] System::String ^ % Extension, [Runtime::InteropServices::Out] System::String ^ % MimeType, [Runtime::InteropServices::Out] System::String ^ % Encoding, [Runtime::InteropServices::Out] cli::array <ReportExecution2005::Warning ^> ^ % Warnings, [Runtime::InteropServices::Out] cli::array <System::String ^> ^ % StreamIds);

public byte[] Render2(string Format, string DeviceInfo, ReportExecution2005.PageCountMode PaginationMode, out string Extension, out string MimeType, out string Encoding, out ReportExecution2005.Warning[] Warnings, out string[] StreamIds);

member this.Render2 : string * string * ReportExecution2005.PageCountMode * string * string * string * Warning[] * String[] -> byte[]

Public Function Render2 (Format As String, DeviceInfo As String, PaginationMode As PageCountMode, ByRef Extension As String, ByRef MimeType As String, ByRef Encoding As String, ByRef Warnings As Warning(), ByRef StreamIds As String()) As Byte()

参数

Format: String

报告的格式。该参数映射到渲染扩展。支持的扩展包括 XML、NULL、CSV、IMAGE、PDF、HTML4.0、HTML3.2、MHTML、EXCEL 和 Word。通过调用该 ListRenderingExtensions() 方法可以获得支持扩展的列表。

DeviceInfo: String

一个包含参数中渲染 Format 扩展所需的设备特定内容的XML字符串。 DeviceInfo 的设置必须作为 DeviceInfo XML 元素的内部元素传递。有关特定输出格式的设备信息设置的更多信息，请参见 “将设备信息设置传递给渲染扩展”。

PaginationMode: PageCountMode

报告处理的模式。

Extension: String

[出]对应输出流的文件扩展名。

MimeType: String

[出]渲染报告的MIME类型。

Encoding: String

[出]报告服务器渲染报告内容时使用的编码。

Warnings: Warning[]

[出]一组 Warning 对象，描述报告处理过程中出现的任何警告。

StreamIds: String[]

[出]流标识符。这些ID会传递给方法。RenderStream(String, String, String, String, String) 你可以用它们来渲染与某个报告相关的外部资源（图片等）。

Byte[]

报告的 字节[] 数组，格式为指定格式。

注解

下表显示了该操作的头部和权限信息。


SOAP头的使用	（在） TrustedUserHeaderValue （在） ExecutionHeaderValue （出局） ServerInfoHeaderValue
本地模式所需权限	关于主报告及所有子报告： ReadProperties AND ExecuteAndView
SharePoint 模式必要权限	关于主报告及所有子报告： <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Render2 渲染与报头中识别 ExecutionInfo2 的报告执行相关的处理中报告。如果不存在会话快照，该方法会执行报告（前提是满足所有凭证和参数要求），从而创建一个新的会话快照。如果报告因非查询参数值发生变化需要重新处理，快照将被重新处理。

如果执行选项设置为缓存或执行快照，调用可以 Render2 使用已有的快照。

如果报告设置为缓存且提供的参数值和凭证匹配，快照的缓存副本可能会被加载，而非实际处理报告。

如果未满足凭证和参数要求，该方法将返回错误。

如果渲染扩展支持指定多个页面，后续调用可以用 Render2 来获取报告的额外页面。

渲染方法的一个限制是输出无法流式传输，因此整个文件必须存储在内存中。

请参见 “识别执行状态 ”一节，了解执行生命周期，其中包含加载和渲染报告所需步骤的描述。

适用于