ReportingService2010.ListChildren(String, Boolean) Méthode

Référence

Définition

Espace de noms:: ReportService2010

Assembly:: ReportService2010.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient la liste des enfants d’un dossier spécifié.

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

Paramètres

ItemPath: String

Nom du chemin d'accès complet du dossier parent.

Recursive: Boolean

Expression Boolean qui indique s'il faut retourner l'arborescence complète des éléments enfants figurant sous l'élément spécifié. La valeur par défaut est false.

Remarque La définition de ce paramètre sur true en mode SharePoint peut réduire considérablement les performances de votre application.

Retours

CatalogItem[]

Tableau d'objets CatalogItem. Cette méthode retourne un tableau vide si aucun enfant n'existe.

Attributs: SoapDocumentMethodAttribute SoapHeaderAttribute

Exemples

Pour compiler l’exemple de code suivant, vous devez référencer le Reporting Services WSDL et importer certains espaces de noms. Pour plus d’informations, consultez Compilation et exécution d’exemples de code. L’exemple de code suivant utilise la ListChildren méthode pour lire le contenu de la racine de l’arborescence de répertoires du serveur de rapports, puis stocke le premier élément et ses propriétés sous forme de document 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);  
      }  
   }  
}

Remarques

Le tableau suivant présente les informations relatives aux en-têtes et aux autorisations sur cette opération.


Utilisation de l’en-tête SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Autorisations requises en mode natif	ReadProperties pour `Item`
Mode SharePoint Autorisations requises	<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Cette méthode retourne uniquement les éléments enfants que l’utilisateur est autorisé à afficher. Les éléments retournés peuvent ne pas représenter une liste complète des éléments enfants de l’élément parent spécifié.

Si cette méthode est appelée à la racine de la base de données du serveur de rapports avec Mes rapports activé, la méthode retourne un tableau d’objets contenant des CatalogItem propriétés pour le dossier Mes rapports. Si l’utilisateur est anonyme et Que Mes rapports est activé, les propriétés de Mes rapports ne sont pas retournées lorsque cette méthode est appelée à la racine.

Cette méthode peut retourner la VirtualPath propriété des éléments de la base de données du serveur de rapports qui prend en charge les chemins virtuels. Le chemin d’accès virtuel est le chemin sous lequel un utilisateur s’attend à voir l’élément. Par exemple, un rapport appelé « Report1 » situé dans le dossier Personnel Mes rapports de l’utilisateur a un chemin d’accès virtuel égal à « /Mes rapports ». Le chemin d’accès réel de l’élément est /Users/Username/My Reports.

La majorité des propriétés retournées par cette méthode sont en lecture seule. Pour plus d’informations sur les propriétés d’élément dans Reporting Services, consultez Propriétés de l’élément du serveur de rapports.

S’applique à

Partager via