Lenguaje

ReportingService2005.ListChildren(String, Boolean) Método

Definición

Obtiene una lista de hijos de una carpeta 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

El nombre completo de la ruta de la carpeta padre.

Recursive
Boolean

Una Boolean expresión que indica si se debe devolver todo el árbol de elementos hijos por debajo del elemento especificado. El valor por defecto es false.

Devoluciones

Una matriz de objetos CatalogItem. Si no existen hijos, este método devuelve un objeto vacío CatalogItem .

Ejemplos

Para compilar el siguiente ejemplo de código, debes consultar el WSDL de Reporting Services e importar ciertos espacios de nombres. Para más información, consulte Ejemplos de Compilación y Ejecución de Código. El siguiente ejemplo de código utiliza el ListChildren método para leer el contenido de la raíz del árbol de directorios del servidor de informes, y luego almacena el primer elemento y sus propiedades como un 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);  
      }  
   }  
}  

Comentarios

La siguiente tabla muestra la información sobre cabeceras y permisos sobre esta operación.

Encabezados SOAP (Fuera) ServerInfoHeaderValue
Permisos necesarios ReadProperties en Item

El ListChildren método devuelve solo los elementos hijos que el usuario tiene permiso para ver. Los elementos devueltos pueden no representar una lista completa de elementos hijos del elemento principal especificado.

Si el ListChildren método se llama en la raíz de la base de datos del servidor de informes con My Reports activado, el método devuelve un array de CatalogItem objetos que contienen propiedades para la carpeta My Reports. Si el usuario es anónimo y My Reports está activado, las propiedades de My Reports no se devuelven cuando ListChildren se llama en la raíz.

El ListChildren método puede devolver la VirtualPath propiedad de elementos en la base de datos del servidor de informes que soportan rutas virtuales. El camino virtual es el camino bajo el cual el usuario espera ver el elemento. Por ejemplo, un informe llamado "Report1" ubicado en la carpeta personal Mis Informes del usuario tiene una ruta virtual igual a "/Mis Informes". La ruta real del artículo es /Usuarios/Nombre de usuario/Mis Informes.

La mayoría de las propiedades que este método devuelve son de solo lectura. Para más información sobre las propiedades de los elementos en Reporting Services, consulte Propiedades de los elementos del Servidor de Reportes.

Se aplica a