ReportExecutionService.Render 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
处理特定报表并以指定格式渲染。
public:
cli::array <System::Byte> ^ Render(System::String ^ Format, System::String ^ DeviceInfo, [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[] Render(string Format, string DeviceInfo, out string Extension, out string MimeType, out string Encoding, out ReportExecution2005.Warning[] Warnings, out string[] StreamIds);
member this.Render : string * string * string * string * string * Warning[] * String[] -> byte[]
Public Function Render (Format As String, DeviceInfo As String, 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 元素的内部元素传递。 有关特定输出格式的设备信息设置的更多信息,请参见 “将设备信息设置传递给渲染扩展”。
- Extension
- String
[出]对应输出流的文件扩展名。
- MimeType
- String
[出]渲染报告的MIME类型。
- Encoding
- String
[出]报告服务器渲染报告内容时使用的编码。
- StreamIds
- String[]
[出]流标识符。 这些ID会传递给方法。RenderStream(String, String, String, String, String) 你可以用它们来渲染与某个报告相关的外部资源(图片等)。
如果使用IMAGE渲染扩展,该方法输出一个空数组。StreamIds
返回
报告的 字节[] 数组,格式为指定格式。
示例
要编译以下代码示例,您必须引用 Reporting Services WSDL 并导入特定的命名空间。 更多信息请参见编 译与运行代码示例。 以下代码示例以 MHTML 渲染报告,并将其保存为 .mht 文件到磁盘。
Imports System
Imports System.IO
Imports System.Web.Services.Protocols
Imports myNamespace.MyReferenceName
Class Sample
Public Shared Sub Main()
Dim rs As New ReportExecutionService()
rs.Credentials = System.Net.CredentialCache.DefaultCredentials
rs.Url = "http://myserver/reportserver/ReportExecution2005.asmx"
' Render arguments
Dim result As Byte() = Nothing
Dim reportPath As String = "/AdventureWorks Sample Reports/Employee Sales Summary "
Dim format As String = "MHTML"
Dim historyID As String = Nothing
Dim devInfo As String = "<DeviceInfo><Toolbar>False</Toolbar></DeviceInfo>"
' Prepare report parameter.
Dim parameters(2) As ParameterValue
parameters(0) = New ParameterValue()
parameters(0).Name = "EmpID"
parameters(0).Value = "288"
parameters(1) = New ParameterValue()
parameters(1).Name = "ReportMonth"
parameters(1).Value = "6" ' June
parameters(2) = New ParameterValue()
parameters(2).Name = "ReportYear"
parameters(2).Value = "2004"
Dim credentials As DataSourceCredentials() = Nothing
Dim showHideToggle As String = Nothing
Dim encoding As String = ""
Dim mimeType As String = ""
Dim warnings As Warning() = Nothing
Dim reportHistoryParameters As ParameterValue() = Nothing
Dim streamIDs As String() = Nothing
Dim execInfo As New ExecutionInfo
Dim execHeader As New ExecutionHeader()
Dim SessionId As String
Dim extension As String = ""
rs.ExecutionHeaderValue = execHeader
execInfo = rs.LoadReport(reportPath, historyID)
rs.SetExecutionParameters(parameters, "en-us")
SessionId = rs.ExecutionHeaderValue.ExecutionID
Console.WriteLine("SessionID: {0}", rs.ExecutionHeaderValue.ExecutionID)
Try
result = rs.Render(format, devInfo, extension, _
encoding, mimeType, warnings, streamIDs)
execInfo = rs.GetExecutionInfo()
Console.WriteLine("Execution date and time: {0}", execInfo.ExecutionDateTime)
Catch e As SoapException
Console.WriteLine(e.Detail.OuterXml)
End Try
' Write the contents of the report to an MHTML file.
Try
Dim stream As FileStream = File.Create("report.mht", result.Length)
Console.WriteLine("File created.")
stream.Write(result, 0, result.Length)
Console.WriteLine("Result written to the file.")
stream.Close()
Catch e As Exception
Console.WriteLine(e.Message)
End Try
End Sub 'Main
End Class
using System;
using System.IO;
using System.Web.Services.Protocols;
using myNamespace.MyReferenceName;
class Sample
{
static void Main(string[] args)
{
ReportExecutionService rs = new ReportExecutionService();
rs.Credentials = System.Net.CredentialCache.DefaultCredentials;
rs.Url = "http://myserver/reportserver/ReportExecution2005.asmx";
// Render arguments
byte[] result = null;
string reportPath = "/AdventureWorks Sample Reports/Employee Sales Summary";
string format = "MHTML";
string historyID = null;
string devInfo = @"<DeviceInfo><Toolbar>False</Toolbar></DeviceInfo>";
// Prepare report parameter.
ParameterValue[] parameters = new ParameterValue[3];
parameters[0] = new ParameterValue();
parameters[0].Name = "EmpID";
parameters[0].Value = "288";
parameters[1] = new ParameterValue();
parameters[1].Name = "ReportMonth";
parameters[1].Value = "6"; // June
parameters[2] = new ParameterValue();
parameters[2].Name = "ReportYear";
parameters[2].Value = "2004";
DataSourceCredentials[] credentials = null;
string showHideToggle = null;
string encoding;
string mimeType;
string extension;
Warning[] warnings = null;
ParameterValue[] reportHistoryParameters = null;
string[] streamIDs = null;
ExecutionInfo execInfo = new ExecutionInfo();
ExecutionHeader execHeader = new ExecutionHeader();
rs.ExecutionHeaderValue = execHeader;
execInfo = rs.LoadReport(reportPath, historyID);
rs.SetExecutionParameters(parameters, "en-us");
String SessionId = rs.ExecutionHeaderValue.ExecutionID;
Console.WriteLine("SessionID: {0}", rs.ExecutionHeaderValue.ExecutionID);
try
{
result = rs.Render(format, devInfo, out extension, out encoding, out mimeType, out warnings, out streamIDs);
execInfo = rs.GetExecutionInfo();
Console.WriteLine("Execution date and time: {0}", execInfo.ExecutionDateTime);
}
catch (SoapException e)
{
Console.WriteLine(e.Detail.OuterXml);
}
// Write the contents of the report to an MHTML file.
try
{
FileStream stream = File.Create("report.mht", result.Length);
Console.WriteLine("File created.");
stream.Write(result, 0, result.Length);
Console.WriteLine("Result written to the file.");
stream.Close();
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
}
}
注解
下表显示了该操作的头部和权限信息。
| SOAP头的使用 | (在) TrustedUserHeaderValue (在) ExecutionHeaderValue (出局) ServerInfoHeaderValue |
| 本地模式所需权限 | 关于主报告及所有子报告: ReadProperties AND ExecuteAndView |
| SharePoint 模式 必要权限 | 关于主报告及所有子报告: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Render 渲染与报头中识别 ExecutionInfo 的报告执行相关的处理中报告。 如果执行状态中处理的报告不存在临时快照,该方法将执行报告(前提是满足所有凭证和参数要求),从而为执行状态创建临时快照。 如果报告因非查询参数值发生变化而被重新处理,则会创建一个新的临时快照。 有关执行状态的更多信息,请参见 识别执行状态。
如果执行选项设置为缓存或执行快照,调用 可以 Render 使用已有的快照。
如果报告设置为缓存且提供的参数值和凭证匹配,快照的缓存副本可能会被加载,而非实际处理报告。
如果未满足凭证和参数要求,该方法将返回错误。
如果渲染扩展支持指定多个页面,后续调用 可以用 Render 来获取报告的额外页面。
渲染方法的一个限制是输出无法流式传输,因此整个文件必须存储在内存中。
请参见 “识别执行状态 ”一节,了解执行生命周期,其中包含加载和渲染报告所需步骤的描述。