ReportingService2005.SetReportDefinition(String, Byte[]) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.