ReportingService2010.ListChildren(String, Boolean) 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.

Mendapatkan daftar turunan dari folder tertentu.

public:
 cli::array <ReportService2010::CatalogItem ^> ^ ListChildren(System::String ^ ItemPath, bool Recursive);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/ListChildren", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public ReportService2010.CatalogItem[] ListChildren (string ItemPath, bool Recursive);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/ListChildren", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.ListChildren : string * bool -> ReportService2010.CatalogItem[]

Public Function ListChildren (ItemPath As String, Recursive As Boolean) As CatalogItem()

Parameter

ItemPath: String

Nama jalur lengkap folder induk.

Recursive: Boolean

Ekspresi Boolean yang menunjukkan apakah akan mengembalikan seluruh pohon item anak di bawah item yang ditentukan. Nilai defaultnya adalah false.

Catatan Mengatur parameter ini ke true dalam mode SharePoint dapat secara signifikan mengurangi performa aplikasi Anda.

Mengembalikan

CatalogItem[]

Array CatalogItem objek. Jika tidak ada turunan, metode ini mengembalikan array kosong.

Atribut: SoapDocumentMethodAttribute SoapHeaderAttribute

Contoh

Untuk mengkompilasi contoh kode berikut, Anda harus mereferensikan Reporting Services WSDL dan mengimpor namespace tertentu. Untuk informasi selengkapnya, lihat Mengkompilasi dan Menjalankan Contoh Kode. Contoh kode berikut menggunakan ListChildren metode untuk membaca konten akar pohon direktori server laporan, lalu menyimpan item pertama dan propertinya sebagai dokumen XML:

Imports System  
Imports System.IO  
Imports System.Text  
Imports System.Web.Services.Protocols  
Imports System.Xml  
Imports System.Xml.Serialization  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2010()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Dim items As CatalogItem() = Nothing  

      ' Retrieve a list of all items from the report server database.   
      Try  
         items = rs.ListChildren("/", True)  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml.ToString())  
      End Try  

      ' Serialize the contents as an XML document and write the contents to a file.  
      Try  
         Dim fs As New FileStream("CatalogItems.xml", FileMode.Create)  
         Dim writer As New XmlTextWriter(fs, Encoding.Unicode)  

         Dim serializer As New XmlSerializer(GetType(CatalogItem()))  
         serializer.Serialize(writer, items)  

         Console.WriteLine("Server contents successfully written to a file.")  

      Catch e As Exception  
         Console.WriteLine(e.Message)  
      End Try  
   End Sub 'Main  
End Class 'Sample

using System;  
using System.IO;  
using System.Text;  
using System.Web.Services.Protocols;  
using System.Xml;  
using System.Xml.Serialization;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService2010 rs = new ReportingService2010();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      CatalogItem[] items = null;  

      // Retrieve a list of all items from the report server database.   
      try  
      {  
         items = rs.ListChildren("/", true);  
      }  

      catch (SoapException e)  
      {  
         Console.WriteLine(e.Detail.OuterXml);  
      }  

      // Serialize the contents as an XML document and write the contents to a file.  
      try  
      {  
         FileStream fs = new FileStream("CatalogItems.xml", FileMode.Create);  
         XmlTextWriter writer = new XmlTextWriter(fs, Encoding.Unicode);   

         XmlSerializer serializer = new XmlSerializer(typeof(CatalogItem[]));  
         serializer.Serialize(writer, items);  

         Console.WriteLine("Server contents successfully written to a file.");  
      }  

      catch (Exception e)  
      {  
         Console.WriteLine(e.Message);  
      }  
   }  
}

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	ReadProperties Pada `Item`
Izin Yang Diperlukan Mode SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Metode ini hanya mengembalikan item turunan yang izin untuk dilihat pengguna. Item yang dikembalikan mungkin tidak mewakili daftar lengkap item anak dari item induk yang ditentukan.

Jika metode ini dipanggil pada akar database server laporan dengan Laporan Saya diaktifkan, metode mengembalikan array CatalogItem objek yang berisi properti untuk folder Laporan Saya. Jika pengguna bersifat anonim dan Laporan Saya diaktifkan, properti untuk Laporan Saya tidak dikembalikan ketika metode ini dipanggil pada akar.

Metode ini dapat mengembalikan VirtualPath properti item dalam database server laporan yang mendukung jalur virtual. Jalur virtual adalah jalur di mana pengguna mengharapkan untuk melihat item. Misalnya, laporan yang disebut "Report1" yang terletak di folder Laporan Saya pribadi pengguna memiliki jalur virtual yang sama dengan "/Laporan Saya". Jalur aktual item adalah /Users/Username/My Reports.

Sebagian besar properti yang dikembalikan metode ini bersifat baca-saja. Untuk informasi selengkapnya tentang properti item di Reporting Services, lihat Properti Item Server Laporan.

Berlaku untuk

Bagikan melalui