ReportingService2005.CreateResource Method

Definition

Namespace:

ReportService2005

Assembly:

ReportService2005.dll

Adds a new resource to the report server database.

public:
 void CreateResource(System::String ^ Resource, System::String ^ Parent, bool Overwrite, cli::array <System::Byte> ^ Contents, System::String ^ MimeType, cli::array <ReportService2005::Property ^> ^ Properties);

public void CreateResource (string Resource, string Parent, bool Overwrite, byte[] Contents, string MimeType, ReportService2005.Property[] Properties);

member this.CreateResource : string * string * bool * byte[] * string * ReportService2005.Property[] -> unit

Public Sub CreateResource (Resource As String, Parent As String, Overwrite As Boolean, Contents As Byte(), MimeType As String, Properties As Property())

Parameters

Resource

String

The name of the new resource.

Parent

String

The fully qualified URL of the parent folder to which to add the new resource.

Overwrite

Boolean

A Boolean expression that specifies whether to overwrite an existing resource with the same name and path. The default value is false.

Contents

Byte[]

The contents of the resource file.

MimeType

String

The Multipurpose Internet Mail Extensions (MIME) type of the resource. The maximum size is 260 characters.

Properties

Property[]

An array of Property objects that defines the property names and values to set for the resource.

Remarks

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

SOAP Headers	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Required Permissions	Creating a new resource: CreateResource on Parent Updating an existing resource: UpdateContent on Resource Updating resource properties: UpdateContent AND UpdateProperties 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 the report server database modifies the ModifiedBy and ModifiedDate properties of the parent folder.