Idioma

ReportingService2005.ListChildren(String, Boolean) Método

Definição

Recebe uma lista dos filhos de uma pasta especificada.

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

Parâmetros

Item
String

O nome completo do caminho da pasta pai.

Recursive
Boolean

Uma Boolean expressão que indica se deve retornar toda a árvore de itens filhos abaixo do item especificado. O valor padrão é false.

Retornos

Uma matriz de objetos CatalogItem. Se não existirem filhos, esse método retorna um objeto vazio CatalogItem .

Exemplos

Para compilar o exemplo de código a seguir, você deve consultar o WSDL do Reporting Services e importar certos namespaces. Para mais informações, veja Exemplos de Código Compilando e Executando. O exemplo de código a seguir usa o ListChildren método para ler o conteúdo da raiz da árvore de diretórios do servidor de relatórios e, em seguida, armazena o primeiro item e suas propriedades como um documento 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);  
      }  
   }  
}  

Comentários

A tabela abaixo mostra informações sobre cabeçalhos e permissões sobre esta operação.

Cabeçalhos SOAP (Fora) ServerInfoHeaderValue
Permissões necessárias ReadProperties em Item

O ListChildren método retorna apenas itens filhos que o usuário tem permissão para visualizar. Os itens devolvidos podem não representar uma lista completa dos itens filhos do item pai especificado.

Se o ListChildren método for chamado na raiz do banco de dados do servidor de relatórios com o My Reports ativado, o método retorna um array de CatalogItem objetos contendo propriedades da pasta My Reports. Se o usuário for anônimo e o Meus Relatórios estiver ativado, as propriedades de Meus Relatórios não são retornadas quando ListChildren é chamado na raiz.

O ListChildren método pode retornar a VirtualPath propriedade de itens no banco de dados do servidor de relatórios que suportam caminhos virtuais. O caminho virtual é o caminho sob o qual o usuário espera ver o item. Por exemplo, um relatório chamado "Report1" localizado na pasta pessoal Meus Relatórios do usuário tem um caminho virtual igual a "/Meus Relatórios". O caminho real do item é /Usuários/Nome de Usuário/Meus Relatórios.

A maioria das propriedades que esse método retorna são somente leitura. Para mais informações sobre propriedades de itens no Reporting Services, veja Propriedades de Itens do Servidor de Relatórios.

Aplica-se a