ReportingService2005.CreateFolder(String, String, Property[]) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
向报告服务器数据库添加一个文件夹。
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
添加新文件夹的父文件夹的完整路径名称。
示例
要编译此代码示例,您必须引用 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 。