ReportingService2006.CreateFolder Method

Article
12/03/2008

Adds a folder to a SharePoint library.

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

Syntax

'Declaration
Public Function CreateFolder ( _
    Folder As String, _
    Parent As String _
) As CatalogItem

public CatalogItem CreateFolder (
    string Folder,
    string Parent
)

public:
CatalogItem^ CreateFolder (
    String^ Folder, 
    String^ Parent
)

public CatalogItem CreateFolder (
    String Folder, 
    String Parent
)

public function CreateFolder (
    Folder : String, 
    Parent : String
) : CatalogItem

Parameters

Folder
The name of the new folder.

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

Return Value

A CatalogItem object for the newly created folder.

Remarks

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

Example

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);
        }
    }
}

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols

Class Sample

    Public Shared Sub Main()

        Dim rs As New ReportingService2006()
        rs.Url = "http://<Server Name>" + _
            "/_vti_bin/ReportServer/ReportService2006.asmx"
        rs.Credentials = _
            System.Net.CredentialCache.DefaultCredentials

        Dim folderName As String = "Budget"
        Dim parentPath As String = _
            "http://<Server Name>/Docs/Documents/"

        Try
            rs.CreateFolder(folderName, parentPath)
            Console.WriteLine("Folder created: {0}", folderName)

        Catch e As SoapException
            Console.WriteLine(e.Detail.InnerXml)
        End Try

    End Sub

End Class

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

Windows 98, Windows 2000, Windows 2000 Server, Windows CE, Windows Server 2008, Windows 98 Second Edition, Pocket PC, Smart Phone, Windows Server 2003, Windows XP Professional with Service Pack 2 (SP2), Windows 2000 Professional, Windows 2000 Advanced Server, Windows XP Home Edition, For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005., Windows Vista, Windows Mobile 5.0, Windows Mobile 2003 for Pocket PC, Windows CE 5.0

Share via