ReportingService2010.ListChildren(String, Boolean) 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.
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
Array CatalogItem objek. Jika tidak ada turunan, metode ini mengembalikan array kosong.
- Atribut
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.