ReportingService2005.CreateFolder(String, String, Property[]) Metode
Definisi
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.
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())
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.
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 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);
}
}
}
Keterangan
Tabel di bawah ini memperlihatkan informasi header dan izin pada operasi ini.
Header SOAP | (Dalam) BatchHeaderValue (Keluar) ServerInfoHeaderValue |
Memerlukan izin | CreateFolder |
Panjang nama jalur lengkap untuk folder baru tidak boleh melebihi 260 karakter; jika tidak, pengecualian SOAP dilemparkan dengan kode rsItemPathLengthExceeded
kesalahan .
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.