ReportingService2005.ListChildren(String, Boolean) ReportingService2005.ListChildren(String, Boolean) ReportingService2005.ListChildren(String, Boolean) Method

정의

지정된 폴더의 자식 목록을 가져옵니다. Gets a list of children of a specified folder.

public:
 cli::array <ReportService2005::CatalogItem ^> ^ ListChildren(System::String ^ Item, bool Recursive);
public ReportService2005.CatalogItem[] ListChildren (string Item, bool Recursive);
Public Function ListChildren (Item As String, Recursive As Boolean) As CatalogItem()
매개 변수
Item
String String String

부모 폴더의 전체 경로 이름입니다. The full path name of the parent folder.

Recursive
Boolean Boolean Boolean

자식 항목의 전체 트리를 지정된 항목 아래에 반환할지 여부를 나타내는 Boolean 식입니다. A Boolean expression that indicates whether to return the entire tree of child items below the specified item. 기본값은 false입니다. The default value is false.

반환

배열 CatalogItem 개체입니다. An array of CatalogItem objects. 이 메서드는 빈 반환 자식이 없으면 CatalogItem 개체입니다. If no children exist, this method returns an empty CatalogItem object.

예제

다음 코드 예제를 컴파일하려면 Reporting Services WSDL 참조 하 고 특정 네임 스페이스를 가져올 해야 합니다.To compile the following code example, you must reference the Reporting Services WSDL and import certain namespaces. 자세한 내용은 참조 컴파일 및 코드 예제를 실행합니다.For more information, see Compiling and Running Code Examples. 다음 코드 예제에서는 ListChildren 메서드 디렉터리 트리를 보고서 서버의 루트의 내용을 읽고를 첫 번째 항목 및 해당 속성을 XML 문서로 저장 합니다.The following code example uses the ListChildren method to read the contents of the root of the report server directory tree, and then stores the first item and its properties as an XML document:

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);  
      }  
   }  
}  

설명

다음 표에서는 이 작업에 대한 헤더 및 사용 권한 정보를 보여 줍니다.The table below shows header and permissions information on this operation.

SOAP 헤더SOAP Headers (Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
필요한 권한Required Permissions ReadProperties 에서 ItemReadProperties on Item

ListChildren 메서드는 사용자가 볼 수 있는 자식 항목만 반환 합니다.The ListChildren method returns only child items that the user has permission to view. 반환 되는 항목에 지정된 된 부모 항목의 자식 항목의 전체 목록은 나타내지 않을 수 있습니다.The items that are returned may not represent a complete list of child items of the specified parent item.

경우는 ListChildren 메서드는 보고서 서버 데이터베이스의 루트에 사용 하도록 설정 하는 내 보고서, 메서드가의 배열을 반환 CatalogItem 내 보고서 폴더에 대 한 속성을 포함 하는 개체입니다.If the ListChildren method is called on the root of the report server database with My Reports enabled, the method returns an array of CatalogItem objects containing properties for the folder My Reports. 익명 사용자가 내 보고서 설정 하는 경우 내 보고서에 대 한 속성은 반환 되지 경우 ListChildren 루트에 호출 됩니다.If the user is anonymous and My Reports is enabled, the properties for My Reports are not returned when ListChildren is called on the root.

ListChildren 메서드가 반환할 수는 VirtualPath 지 원하는 가상 경로 보고서 서버 데이터베이스에 있는 항목의 속성입니다.The ListChildren method can return the VirtualPath property of items in the report server database that support virtual paths. 가상 경로가는 항목을 볼은 사용자가 경로 보여 줍니다.The virtual path is the path under which a user expects to see the item. 예를 들어 사용자의 개인 내 보고서 폴더에 있는 "Report1" 이라는 보고서 "/My Reports" 가상 경로 있습니다.For example, a report called "Report1" located in the user's personal My Reports folder has a virtual path equal to "/My Reports". 항목의 실제 경로 /Users/Username/My Reports입니다.The actual path of the item is /Users/Username/My Reports.

이 메서드가 반환 하는 속성의 대부분은 읽기 전용입니다.The majority of the properties this method returns are read-only. Reporting Services에서 항목 속성에 대 한 자세한 내용은 참조 보고서 서버 항목 속성합니다.For more information about item properties in Reporting Services, see Report Server Item Properties.

적용 대상