ReportExecutionService.LoadReport Method (String, String)
Applies To: SQL Server 2016 Preview
Loads a report from the report server into a new execution.
Namespace: ReportExecution2005
Assembly: ReportExecution2005 (in ReportExecution2005.dll)
Syntax
public ExecutionInfo LoadReport(
string Report,
string HistoryID
)
public:
ExecutionInfo^ LoadReport(
String^ Report,
String^ HistoryID
)
member LoadReport :
Report:string *
HistoryID:string -> ExecutionInfo
Public Function LoadReport (
Report As String,
HistoryID As String
) As ExecutionInfo
Parameters
Report
Type: System.StringThe full name of the report.
HistoryID
Type: System.StringThe history ID of the snapshot.
Return Value
Type: ReportExecution2005.ExecutionInfo
An ExecutionInfo object containing information for the loaded report.
Remarks
The table below shows header and permissions information on this operation.
SOAP Header Usage |
(Out) ExecutionHeaderValue (Out) ServerInfoHeaderValue |
Native Mode Required Permissions |
On the main report: ReadProperties AND ExecuteAndView On all subreports: ReadProperties |
SharePoint Mode Required Permissions |
On the main report and all subreports: ViewListItems |
This method should be called prior to calling the Render method for a report.
Depending on the execution properties of the report, the returned ExecutionInfo may either be a snapshot ready to be rendered or a report that needs to be processed. If a HistoryID is specified, the report has already been processed and it will be able to be rendered immediately.
The returned ExecutionInfo object will contain a new ExecutionID.
By default, report edit sessions are set to 7200 seconds (2 hours) from last use, making it possible for users to keep a large amount of data in the cache for a prolonged period of time. In some usage patterns, this could lead to a larger load on the RSTempDB database and the report server. In these cases you should consider using LoadReport.
Examples
Legacy Code Example
For a code example, please see the Render method.
See Also
ReportExecutionService Class
ReportExecution2005 Namespace
Return to top