ReportExecutionService.LoadReportDefinition Method

Article
12/15/2008

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

Espace de noms: Microsoft.WSSUX.ReportingServicesWebService.RSExecutionService2005
Assembly: ReportExecution2005 (in reportexecutionservice.dll)

Syntaxe

'Déclaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/LoadReportDefinition", RequestNamespace:="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace:="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction:=SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("ExecutionHeaderValue", Direction:=SoapHeaderDirection.Out)> _
Public Function LoadReportDefinition ( _
    Definition As Byte(), _
    <OutAttribute> ByRef warnings As Warning() _
) As ExecutionInfo

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/LoadReportDefinition", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)] 
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out)] 
[SoapHeaderAttribute("ExecutionHeaderValue", Direction=SoapHeaderDirection.Out)] 
public ExecutionInfo LoadReportDefinition (
    byte[] Definition,
    out Warning[] warnings
)

[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/LoadReportDefinition", RequestNamespace=L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace=L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse::Literal, ParameterStyle=SoapParameterStyle::Wrapped)] 
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction=SoapHeaderDirection::Out)] 
[SoapHeaderAttribute(L"ExecutionHeaderValue", Direction=SoapHeaderDirection::Out)] 
public:
ExecutionInfo^ LoadReportDefinition (
    array<unsigned char>^ Definition, 
    [OutAttribute] array<Warning^>^% warnings
)

/** @attribute SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/LoadReportDefinition", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped) */ 
/** @attribute SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out) */ 
/** @attribute SoapHeaderAttribute("ExecutionHeaderValue", Direction=SoapHeaderDirection.Out) */ 
public ExecutionInfo LoadReportDefinition (
    byte[] Definition, 
    /** @attribute OutAttribute() */ /** @ref */ Warning[] warnings
)

JScript ne prend pas en charge le passage d'arguments de type valeur par référence.

Paramètres

Definition
A byte stream containing the Report Definition Language (RDL) for the report.

warnings
A collection of Warning objects containing warnings that may have occurred during report publishing.

Valeur de retour

An ExecutionInfo object containing information for the report execution.

Notes

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

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

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

Reports instantiated with the LoadReportDefinition method are not securable, and may not be shared with other users - the person who created the execution with LoadReportDefinition 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.

Exemple

Please see Render for an example.

Sécurité des threads

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Plateformes

Plateformes de développement

Pour obtenir la liste des plateformes prises en charge, consultez Configuration matérielle et logicielle requise pour l'installation de SQL Server 2005.

Plateformes cibles