Share via


ReportingService2005.SetReportDefinition(String, Byte[]) Method

Definition

Sets the report definition for a specified report.

public:
 cli::array <ReportService2005::Warning ^> ^ SetReportDefinition(System::String ^ Report, cli::array <System::Byte> ^ Definition);
public ReportService2005.Warning[] SetReportDefinition (string Report, byte[] Definition);
member this.SetReportDefinition : string * byte[] -> ReportService2005.Warning[]
Public Function SetReportDefinition (Report As String, Definition As Byte()) As Warning()

Parameters

Report
String

The fully qualified URL of the report. Accepts an EditSessionID generated by CreateReportEditSession(String, String, Byte[], Warning[]) method.

Definition
Byte[]

The report definition to register. The XML data is defined by the http://schemas.microsoft.com/sqlserver/reporting/2008/01/reportdefinition/ Report Definition Language .

Returns

An array of Warning objects that describes warnings that occurred while the report definition was being validated.

Remarks

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

SOAP Headers (In) BatchHeaderValue

(Out) ServerInfoHeaderValue
Required Permissions UpdateReportDefinition

The length of the Report parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.

The Report parameter cannot be null or empty or contain the following reserved characters: : ? ; @ & = + $ , \ * > < | . ". You can use the forward slash character (/) to separate items in the full path name of the folder, but you cannot use it at the end of the folder name.

Changing the report definition for a report modifies the ModifiedBy, ModifiedDate, and Size properties of the report. The Description property is not affected. Execution settings and snapshots remain valid for the report.

Applies to