ReportExecutionService.LoadReportDefinition2 Method

Creates a report execution from a report definition supplied by the client.

Namespace:  ReportExecution2005
Assembly:  ReportExecution2005 (in ReportExecution2005.dll)

Syntax

'Declaration
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("ExecutionHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/LoadReportDefinition2", RequestNamespace := "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    ResponseNamespace := "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function LoadReportDefinition2 ( _
    Definition As Byte(), _
    <OutAttribute> ByRef warnings As Warning() _
) As ExecutionInfo2
'Usage
Dim instance As ReportExecutionService
Dim Definition As Byte()
Dim warnings As Warning()
Dim returnValue As ExecutionInfo2

returnValue = instance.LoadReportDefinition2(Definition, _
    warnings)
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("ExecutionHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/LoadReportDefinition2", RequestNamespace = "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public ExecutionInfo2 LoadReportDefinition2(
    byte[] Definition,
    out Warning[] warnings
)
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"ExecutionHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute(L"http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/LoadReportDefinition2", RequestNamespace = L"http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = L"http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
public:
ExecutionInfo2^ LoadReportDefinition2(
    array<unsigned char>^ Definition, 
    [OutAttribute] array<Warning^>^% warnings
)
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("ExecutionHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/LoadReportDefinition2", RequestNamespace = "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
member LoadReportDefinition2 : 
        Definition:byte[] * 
        warnings:Warning[] byref -> ExecutionInfo2 
public function LoadReportDefinition2(
    Definition : byte[], 
    warnings : Warning[]
) : ExecutionInfo2

Parameters

  • Definition
    Type: array<System.Byte[]
    A byte stream containing the Report Definition Language (RDL) for the report.

Return Value

Type: ReportExecution2005.ExecutionInfo2
An ExecutionInfo2 object containing information for the report execution.

Remarks

The table below shows header and permissions information on this operation.

SOAP Header Usage

(In) TrustedUserHeaderValue

(Out) ExecutionHeaderValue

(Out) ServerInfoHeaderValue

Native Mode Required Permissions

ReadProperties on all subreports AND ExecuteReportDefinition (System)

SharePoint Mode Required Permissions

ViewListItems() on all subreports AND UseRemoteAPIs()

This method should be called prior to calling the Render2 method for a report.

The returned report execution will need to be processed before it is rendered. A new execution is created and the ExecutionInfo2 is returned with a new ExecutionID value.

Reports instantiated with the LoadReportDefinition2 method are temporary. They are not represented in the report server namespace, and are discarded when the server session expires.

Reports instantiated with the LoadReportDefinition2 method are not securable, and may not be shared with other users; the person who created the execution with LoadReportDefinition2 is the only user who may access them.

Subreports and data source references with relative paths are not supported using this method. However, absolute paths to catalog items can be used.