ReportingService2006.SetReportDefinition Method
Sets the report definition for a specified report.
Namespace: ReportService2006
Assembly: ReportService2006 (in ReportService2006.dll)
Syntax
'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/SetReportDefinition", RequestNamespace := "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", _
ResponseNamespace := "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
Public Function SetReportDefinition ( _
Report As String, _
Definition As Byte() _
) As Warning()
'Usage
Dim instance As ReportingService2006
Dim Report As String
Dim Definition As Byte()
Dim returnValue As Warning()
returnValue = instance.SetReportDefinition(Report, _
Definition)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/SetReportDefinition", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public Warning[] SetReportDefinition(
string Report,
byte[] Definition
)
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/SetReportDefinition", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
public:
array<Warning^>^ SetReportDefinition(
String^ Report,
array<unsigned char>^ Definition
)
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/SetReportDefinition", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member SetReportDefinition :
Report:string *
Definition:byte[] -> Warning[]
public function SetReportDefinition(
Report : String,
Definition : byte[]
) : Warning[]
Parameters
- Report
Type: System.String
The fully qualified URL of the report including the file name and .rdl file name extension.
- Definition
Type: array<System.Byte[]
The report definition to register. The XML data is defined by the https://schemas.microsoft.com/sqlserver/reporting/2008/01/reportdefinition/ Report Definition Language .
Return Value
Type: array<ReportService2006.Warning[]
An array of Warning objects that describes the warnings that occurred when the report definition was being validated.
Remarks
The table below shows header and permissions information on this operation.
SOAP Headers |
(Out) ServerInfoHeaderValue |
Required Permissions |
EditListItems() |
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 existing snapshots remain unchanged for the report.