ReportingService2006.CreateFolder Method (String, String)

 

Adds a folder to a SharePoint library.

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

public CatalogItem CreateFolder(
	string Folder,
	string Parent
)

Parameters

Folder
Type: System.String

The name of the new folder.

Parent
Type: System.String

The fully qualified URL for the parent folder or site that will contain the new folder.

Return Value

Type: ReportService2006.CatalogItem

A CatalogItem object for the newly created folder.

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

SOAP Headers

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

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 rsItemPathLengthExceeded.

Folder names must be less than 128 characters long. The names cannot be null, consist of empty strings, or contain the following reserved characters: : ? @ & = + $ , \ * > < | . ".

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

using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;

class Sample
{
    static void Main(string[] args)
    {
        ReportingService2006 rs = new ReportingService2006();
        rs.Url = "http://<Server Name>" +
            "/_vti_bin/ReportServer/ReportService2006.asmx";
        rs.Credentials = 
            System.Net.CredentialCache.DefaultCredentials;

        string folderName = "Budget";
        string parent = "http://<Server Name>/Docs/Documents/";

        try
        {
            rs.CreateFolder(folderName, parent);
            Console.WriteLine("Folder created: {0}", folderName);
        }
        catch (SoapException e)
        {
            Console.WriteLine(e.Detail.InnerXml);
        }
    }
}
Return to top
Show: