ReportingService2010.SetItemDefinition Method (String, Byte[], Property )

Applies To: SQL Server 2016 Preview

Sets the definition or content for a specified item. This method applies to the Report, Model, Dataset, Component, Resource, and DataSource item types.

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

Syntax

[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemDefinition", 
    RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public Warning[] SetItemDefinition(
    string ItemPath,
    byte[] Definition,
    Property[] Properties
)

public:
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemDefinition", 
    RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
array<Warning^>^ SetItemDefinition(
    String^ ItemPath,
    array<unsigned char>^ Definition,
    array<Property^>^ Properties
)

[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemDefinition",
    RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
member SetItemDefinition : 
        ItemPath:string *
        Definition:byte[] *
        Properties:Property[] -> Warning[]

<SoapHeaderAttribute("TrustedUserHeaderValue")>
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)>
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemDefinition",
    RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)>
Public Function SetItemDefinition (
    ItemPath As String,
    Definition As Byte(),
    Properties As Property()
) As Warning()

Parameters

• ItemPath
  Type: System.String

  The fully qualified URL of the item including the file name and, in SharePoint mode, the extension.

• Definition
  Type: System.Byte[]

  The item definition to register.

• Properties
  Type: ReportService2010.Property[]

  An array of Property objects that defines the properties and values to set for the item.

Return Value

Type: ReportService2010.Warning[]

An array of Warning objects that describes the warnings that occurred when the item definition or content was being validated.

Remarks

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

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

The ItemPath 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.

If ItemType is Report, then the XML data is defined by the Report Definition Language. If ItemType is Model, then the XML data is defined by the Semantic Model Definition Language.

Changing the definition or content for an item modifies the ModifiedBy, ModifiedDate, and Size properties of the item. The Description property is not affected. Execution settings and existing snapshots remain unchanged for the item.

See Also

ReportingService2010 Class
ReportService2010 Namespace

Return to top