语言

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

参数

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 头部 (在) BatchHeaderValue

(出局) ServerInfoHeaderValue
所需的权限 CreateFolder

新文件夹的完整路径名称长度不得超过260字符;否则,会抛出带有错误代码 rsItemPathLengthExceeded的SOAP异常。

文件夹名称必须少于128字符。 这些名称不能为空,不能由空字符串组成,也不能包含以下保留字符:: ? ;@ & = + $ , \ * >< | 。 ". 你可以用斜杠字符(/)分隔文件夹完整路径名称中的项目,但不能在文件夹名称末尾使用。

如果启用了“我的报告”,当你尝试在报告服务器数据库的根文件夹中创建名为“我的报告”的文件夹时,会抛出一个带有错误代码 rsItemAlreadyExists 的SOAP异常。

向报告服务器数据库添加文件夹会 ModifiedBy 修改父文件夹的属性 ModifiedDate 。

适用于