Share via

  • Article

ReportingService2006.CreateFolder Method

Adds a folder to a SharePoint library.

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

Syntax

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

returnValue = instance.CreateFolder(Folder, _
    Parent)

[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateFolder", 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)]
public CatalogItem CreateFolder(
    string Folder,
    string Parent
)

[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateFolder", 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)]
public:
CatalogItem^ CreateFolder(
    String^ Folder, 
    String^ Parent
)

[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2006/03/15/reporting/reportingservices/CreateFolder", 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)>]
member CreateFolder : 
        Folder:string * 
        Parent:string -> CatalogItem 

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

Parameters

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

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

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.

Examples

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