ReportingService2010.ListChildren(String, Boolean) 方法

定义

命名空间:

ReportService2010

程序集:

ReportService2010.dll

获取指定文件夹的子级的列表。

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()

参数

ItemPath

String

父文件夹的完整路径名。

Recursive

Boolean

一个Boolean表达式，该表达式指示是否返回指定项下的整个子项树。 默认值为 false。

注释 在 SharePoint 模式下将此参数设置为 true 可能会显著降低应用程序的性能。

返回

CatalogItem[]

一个 CatalogItem 对象数组。 如果不存在任何子项，则此方法返回一个空数组。

属性

SoapDocumentMethodAttribute SoapHeaderAttribute

示例

若要编译以下代码示例，必须引用 Reporting Services WSDL 并导入某些命名空间。 有关详细信息，请参阅 编译和运行代码示例。 下面的代码示例使用 ListChildren 方法读取报表服务器目录树的根目录的内容，然后将第一项及其属性存储为 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);  
      }  
   }  
}  

注解

下表显示了有关此操作的标头和权限信息。

SOAP 标头用法	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
本机模式所需权限	Item 上的 ReadProperties
SharePoint 模式所需权限	<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

此方法仅返回用户有权查看的子项。 返回的项可能不表示指定父项的子项的完整列表。

如果在启用“我的报表”的情况下对报表服务器数据库的根目录调用此方法，该方法将返回一个对象数组 CatalogItem ，其中包含文件夹“我的报表”的属性。 如果用户是匿名的并且启用了“我的报表”，则当对根目录调用此方法时，不会返回“我的报表”的属性。

此方法可以返回 VirtualPath 报表服务器数据库中支持虚拟路径的项的 属性。 虚拟路径是用户期望在其中查看项的路径。 例如，位于用户个人“我的报表”文件夹中的名为“Report1”的报表的虚拟路径等于“/我的报表”。 该项的实际路径为 /Users/Username/My Reports。

此方法返回的大多数属性都是只读的。 有关 Reporting Services 中的项属性的详细信息，请参阅报表服务器项属性。