ReportingService2005.CreateFolder(String, String, Property[]) メソッド

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())

パラメーター

例

このコード例をコンパイルするには、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);  
      }  
   }  
}  

注釈

以下の表は、この操作のヘッダーおよび権限情報を示しています。

新しいフォルダのフルパス名の長さは260文字を超えてはなりません。そうでなければ、エラーコード rsItemPathLengthExceededを含むSOAP例外がスローされます。

フォルダ名は128文字未満でなければなりません。 名前はnullであってはならず、空文字列で構成されてはいけませんし、以下の予約文字も含めてはいけません:? ;@ & = + $ , \ * >< | ". フォルダーのフルパス名の項目を区切るためにスラッシュ文字(/)を使うことはできますが、フォルダ名の最後に使うことはできません。

My Reportsが有効の場合、レポートサーバーデータベースのルートフォルダに「My Reports」というフォルダを作ろうとすると、エラーコード付きのSOAP例外が rsItemAlreadyExists されます。

レポートサーバーデータベースにフォルダを追加すると、親フォルダの ModifiedBy および ModifiedDate プロパティが変更されます。