Export (0) Print
Expand All

ReportingService2010::CreateFolder Method (String^, String^, array<Property^>^)

 

Applies To: SQL Server 2016 Preview

Adds a folder to the report server database or SharePoint library.

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

public:
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateFolder", 
	RequestNamespace = "http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
	ResponseNamespace = "http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
	Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
CatalogItem^ CreateFolder(
	String^ Folder,
	String^ Parent,
	array<Property^>^ Properties
)

Parameters

Folder
Type: System::String^

The name of the new folder.

Parent
Type: System::String^

The full path name of the parent folder to which to add the new folder.

Properties
Type: array<ReportService2010::Property^>^

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

Return Value

Type: ReportService2010::CatalogItem^

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

SOAP Header Usage

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

Native Mode Required Permissions

CreateFolder

SharePoint Mode Required Permissions

AddListItems

The length of the full path name for the new folder cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.

Folder names must be less than 128 characters long. The names cannot be null, consist of empty strings, 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 My Reports is enabled, a SOAP exception is thrown with the error code rsItemAlreadyExists if you attempt to create a folder named "My Reports" in the root folder of the report server database.

Adding a folder to the report server database modifies the ModifiedBy and ModifiedDate properties of the parent folder.

Legacy Code Example

To compile this code example, you must reference the Reporting Services WSDL and import certain namespaces. For more information, see . The following code example uses the CreateFolder method to create a folder in the report server database:

No code example is currently available or this language may not be supported.
Return to top
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft