ReportingService2006.ListChildren(String) Method

Definition

Namespace:

ReportService2006

Assembly:

ReportService2006.dll

Gets a list of children from a specified folder.

public:
 cli::array <ReportService2006::CatalogItem ^> ^ ListChildren(System::String ^ Item);

public ReportService2006.CatalogItem[] ListChildren (string Item);

member this.ListChildren : string -> ReportService2006.CatalogItem[]

Public Function ListChildren (Item As String) As CatalogItem()

Parameters

Item

String

The fully qualified URL for the folder.

Returns

CatalogItem[]

An array of CatalogItem objects. If no children exist, this method returns an empty CatalogItem array.

Examples

using System;  
using System.Collections.Generic;  
using System.IO;  
using System.Text;  
using System.Web;  
using System.Web.Services;  
using System.Web.Services.Protocols;  

class Sample  
{  
    static void Main(string[] args)  
    {  
        ReportingService2006 rs = new ReportingService2006();  
        rs.Url = "http://<Server Name>/_vti_bin/ReportServer" +  
            "/ReportService2006.asmx";  
        rs.Credentials =   
            System.Net.CredentialCache.DefaultCredentials;  

        CatalogItem[] items = null;  

        try  
        {  
            items = rs.ListChildren("/");  

            foreach (CatalogItem item in items)  
            {  
                Console.WriteLine("Name: " + item.Name);  
                Console.WriteLine("Path: " + item.Path);  
                Console.WriteLine("Type: " + item.Type.ToString());  
            }  
        }  

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

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

Class Sample  

    Public Shared Sub Main()  

        Dim rs As New ReportingService2006()  
        rs.Url = "http://<Server Name>/_vti_bin/ReportServer" + _  
            "/ReportService2006.asmx"  
        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("/")  

            If Not (items Is Nothing) Then  
                For Each item As CatalogItem In items  
                    Console.WriteLine("Name: " + item.Name)  
                    Console.WriteLine("Path: " + item.Path)  
                    Console.WriteLine("Type: " + _  
                        item.Type.ToString())  
                Next  
            End If  

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

    End Sub  

End Class  

Remarks

The table below shows header and permissions information on this operation.

SOAP Headers	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Required Permissions	<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

This method returns all the children of Item to which the user has <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> permission.

Calling ListChildren on the catalog root, “/”, returns the top level list of sites.