ReportingService2005.ListChildren(String, Boolean) Metode

Referensi

Definisi

Ruang nama:: ReportService2005

Rakitan:: ReportService2005.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 <ReportService2005::CatalogItem ^> ^ ListChildren(System::String ^ Item, bool Recursive);

public ReportService2005.CatalogItem[] ListChildren (string Item, bool Recursive);

member this.ListChildren : string * bool -> ReportService2005.CatalogItem[]

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

Parameter

Item: 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.

Mengembalikan

CatalogItem[]

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

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 ReportingService2005()  
      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()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      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.


Header SOAP	(Keluar) ServerInfoHeaderValue
Memerlukan izin	ReadProperties Pada `Item`

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

ListChildren Jika metode 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 saat ListChildren dipanggil pada akar.

Metode ini ListChildren 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