ReportingService2005.CreateFolder(String, String, Property[]) 메서드

정의

네임스페이스:

ReportService2005

어셈블리:

ReportService2005.dll

보고서 서버 데이터베이스에 폴더를 추가합니다.

public:
 void CreateFolder(System::String ^ Folder, System::String ^ Parent, cli::array <ReportService2005::Property ^> ^ Properties);

public void CreateFolder (string Folder, string Parent, ReportService2005.Property[] Properties);

member this.CreateFolder : string * string * ReportService2005.Property[] -> unit

Public Sub CreateFolder (Folder As String, Parent As String, Properties As Property())

매개 변수

Folder

String

새 폴더의 이름입니다.

Parent

String

새 폴더를 추가할 부모 폴더의 전체 경로 이름입니다.

Properties

Property[]

폴더에 대해 설정할 속성 이름과 값을 정의하는 Property 개체의 배열입니다.

예제

이 코드 예제를 컴파일하려면 Reporting Services WSDL을 참조하고 특정 네임스페이스를 가져와야 합니다. 자세한 내용은 코드 예제 컴파일 및 실행을 참조하세요. 다음 코드 예제에서는 메서드를 CreateFolder 사용하여 보고서 서버 데이터베이스에 폴더를 만듭니다.

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      ' Create a custom property for the folder.  
      Dim newProp As New [Property]()  
      newProp.Name = "Department"  
      newProp.Value = "Finance"  
      Dim props(0) As [Property]  
      props(0) = newProp  

      Dim folderName As String = "Budget"  

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

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml)  
      End Try  
   End Sub 'Main  
End Class 'Sample  

using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      // Create a custom property for the folder.  
      Property newProp = new Property();  
      newProp.Name = "Department";  
      newProp.Value = "Finance";  
      Property[] props = new Property[1];  
      props[0] = newProp;  

      string folderName = "Budget";  

      try  
      {  
         rs.CreateFolder(folderName, "/", props);  
         Console.WriteLine("Folder created: {0}", folderName);  
      }  

      catch(SoapException e)  
      {  
         Console.WriteLine(e.Detail.InnerXml);  
      }  
   }  
}  

설명

다음 표에서는 이 작업에 대한 헤더 및 사용 권한 정보를 보여 줍니다.

SOAP 헤더	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
필요한 권한	CreateFolder

새 폴더의 전체 경로 이름 길이는 260자를 초과할 수 없습니다. 그렇지 않으면 오류 코드 rsItemPathLengthExceeded와 함께 SOAP 예외가 throw됩니다.

폴더 이름은 128자 미만이어야 합니다. 이름은 null일 수 없거나, 빈 문자열로 구성되거나, 예약된 문자를 포함할 수 없습니다. : ? ; @ & = + $ , \ * | >< . ". 슬래시 문자(/)를 사용하여 폴더의 전체 경로 이름에 있는 항목을 구분할 수 있지만 폴더 이름 끝에는 사용할 수 없습니다.

내 보고서를 사용하도록 설정하면 보고서 서버 데이터베이스의 루트 폴더에 "내 보고서"라는 폴더를 만들려고 하면 오류 코드 rsItemAlreadyExists 와 함께 SOAP 예외가 throw됩니다.

보고서 서버 데이터베이스에 폴더를 추가하면 부모 폴더의 및 ModifiedDate 속성이 수정됩니다ModifiedBy.