• Article

ReportingService2006.CreateResource Method

Adds a new resource to a SharePoint library.

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

Syntax

'Declaration
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateResource", 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("TrustedUserHeaderValue")> _
Public Function CreateResource ( _
    Resource As String, _
    Parent As String, _
    Overwrite As Boolean, _
    Contents As Byte(), _
    MimeType As String, _
    Properties As Property() _
) As CatalogItem
'Usage
Dim instance As ReportingService2006
Dim Resource As String
Dim Parent As String
Dim Overwrite As Boolean
Dim Contents As Byte()
Dim MimeType As String
Dim Properties As Property()
Dim returnValue As CatalogItem

returnValue = instance.CreateResource(Resource, _
    Parent, Overwrite, Contents, MimeType, _
    Properties)

[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateResource", 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("TrustedUserHeaderValue")]
public CatalogItem CreateResource(
    string Resource,
    string Parent,
    bool Overwrite,
    byte[] Contents,
    string MimeType,
    Property[] Properties
)

[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateResource", 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"TrustedUserHeaderValue")]
public:
CatalogItem^ CreateResource(
    String^ Resource, 
    String^ Parent, 
    bool Overwrite, 
    array<unsigned char>^ Contents, 
    String^ MimeType, 
    array<Property^>^ Properties
)

[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateResource", 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("TrustedUserHeaderValue")>]
member CreateResource : 
        Resource:string * 
        Parent:string * 
        Overwrite:bool * 
        Contents:byte[] * 
        MimeType:string * 
        Properties:Property[] -> CatalogItem 

public function CreateResource(
    Resource : String, 
    Parent : String, 
    Overwrite : boolean, 
    Contents : byte[], 
    MimeType : String, 
    Properties : Property[]
) : CatalogItem

Parameters

  • Parent
    Type: System.String
    The fully qualified URL for the parent folder that will contain the resource.
  • Overwrite
    Type: System.Boolean
    A Boolean expression that specifies whether to overwrite an existing resource with the same name and path. The default value is false.
  • Contents
    Type: array<System.Byte[]
    The contents of the resource file.
  • MimeType
    Type: System.String
    The MIME type of the resource. The maximum size is 260 characters.

Return Value

Type: ReportService2006.CatalogItem
A CatalogItem object for the newly created resource.

Remarks

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

SOAP Headers

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

Required Permissions

Creating a new resource: AddListItems() on Parent

Updating an existing resource: EditListItems() on Resource

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

The Parent 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 errors occur, the resource is not created.

Adding a resource to a SharePoint library modifies the ModifiedBy and ModifiedDate properties of the parent folder.