ReportingService2010.CreateFolder(String, String, Property[]) Metode

Referensi

Definisi

Ruang nama:: ReportService2010

Rakitan:: ReportService2010.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menambahkan folder ke database server laporan atau pustaka SharePoint.

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

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateFolder", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public ReportService2010.CatalogItem CreateFolder (string Folder, string Parent, ReportService2010.Property[] Properties);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateFolder", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.CreateFolder : string * string * ReportService2010.Property[] -> ReportService2010.CatalogItem

Public Function CreateFolder (Folder As String, Parent As String, Properties As Property()) As CatalogItem

Parameter

Folder: String

Nama folder baru.

Parent: String

Nama jalur lengkap folder induk yang akan ditambahkan ke folder baru.

Properties: Property[]

Array Property objek yang menentukan nama dan nilai properti yang akan diatur untuk folder.

Mengembalikan

CatalogItem

Folder yang dibuat.

Atribut: SoapDocumentMethodAttribute SoapHeaderAttribute

Contoh

Untuk mengkompilasi contoh kode ini, Anda harus mereferensikan Reporting Services WSDL dan mengimpor namespace tertentu. Untuk informasi selengkapnya, lihat Mengkompilasi dan Menjalankan Contoh Kode. Contoh kode berikut menggunakan CreateFolder metode untuk membuat folder di database server laporan:

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2010()  
      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 ReportingService2010();  
      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);  
      }  
   }  
}

Keterangan

Tabel di bawah ini memperlihatkan informasi header dan izin pada operasi ini.


Penggunaan Header SOAP	(Dalam) TrustedUserHeaderValue (Keluar) ServerInfoHeaderValue
Izin Yang Diperlukan Mode Asli	CreateFolder
Izin yang Diperlukan Mode SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.AddListItems>

Panjang nama jalur lengkap untuk folder baru tidak boleh melebihi 260 karakter; jika tidak, pengecualian SOAP dilemparkan dengan kode rsItemLengthExceededkesalahan .

Panjang nama folder harus kurang dari 128 karakter. Nama tidak boleh null, terdiri dari string kosong, atau berisi karakter khusus berikut: : ? ; @ & = + $ , \ * >< | . ". Anda dapat menggunakan karakter garis miring (/) untuk memisahkan item dalam nama jalur lengkap folder, tetapi Anda tidak dapat menggunakannya di akhir nama folder.

Jika Laporan Saya diaktifkan, pengecualian SOAP dilemparkan dengan kode rsItemAlreadyExists kesalahan jika Anda mencoba membuat folder bernama "Laporan Saya" di folder akar database server laporan.

Menambahkan folder ke database server laporan memodifikasi ModifiedBy properti dan ModifiedDate folder induk.

Berlaku untuk

Bagikan melalui