ReportingService2005.GetProperties(String, Property[]) Méthode

Définition

Retourne la valeur d'une ou plusieurs propriétés d'un élément dans la base de données du serveur de rapports.

public:
 cli::array <ReportService2005::Property ^> ^ GetProperties(System::String ^ Item, cli::array <ReportService2005::Property ^> ^ Properties);
public ReportService2005.Property[] GetProperties (string Item, ReportService2005.Property[] Properties);
member this.GetProperties : string * ReportService2005.Property[] -> ReportService2005.Property[]
Public Function GetProperties (Item As String, Properties As Property()) As Property()

Paramètres

Item
String

Nom du chemin d'accès complet ou iD de l'élément.

Properties
Property[]

Tableau d'objets Property qui contient les propriétés dont vous voulez récupérer les valeurs.

Retours

Tableau d'objets Property qui représente les propriétés de l'élément spécifié.

Exemples

Pour compiler cet exemple de code, 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 GetProperties méthode pour récupérer la description associée au rapport Ventes d’entreprise :

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      ' Create the property to retrieve.  
      Dim retrieveProp As New [Property]()  
      retrieveProp.Name = "Description"  
      Dim props(0) As [Property]  
      props(0) = retrieveProp  

      Try  
         Dim properties As [Property]() = rs.GetProperties("/SampleReports/Company Sales", props)  

         Dim prop As [Property]  
         For Each prop In  properties  
            ' Writes the description to the console.  
            Console.WriteLine(prop.Value)  
         Next prop  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml.ToString())  
      End Try  
   End Sub 'Main  
End Class 'Sample  
using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      // Create the property to retrieve.  
      Property retrieveProp = new Property();  
      retrieveProp.Name = "Description";  
      Property[] props = new Property[1];  
      props[0] = retrieveProp;  

      try  
      {  
         Property[] properties = rs.GetProperties("/SampleReports/Company Sales", props);  

         foreach (Property prop in properties)  
         {  
            // Writes the description to the console.  
            Console.WriteLine(prop.Value);  
         }  
      }  

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

Remarques

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

En-têtes SOAP (In) ItemNamespaceHeaderValue

(Out) ServerInfoHeaderValue
Autorisations requises Dépend du type d’élément :

- Folder: ReadProperties
- Report: ReadProperties
- Resource: ReadProperties
- DataSource: ReadProperties
- Model: ReadProperties

La valeur par défaut qui doit être passée pour cet argument est le nom du chemin d’accès complet. Pour fournir un ID, vous devez définir l’en-tête ItemNamespaceHeader SOAP. Pour plus d’informations, consultez Définition de l’espace de noms Item pour la méthode GetProperties.

Utilisez la GetProperties méthode pour récupérer l’ensemble complet de propriétés définies par l’utilisateur et réservées. Pour récupérer le sous-ensemble standard de propriétés réservées, utilisez la ListChildren méthode . Pour obtenir la liste des propriétés réservées des éléments dans la base de données du serveur de rapports, consultez Propriétés des éléments du serveur de rapports.

Si le Properties paramètre est null (Nothing en Visual Basic), toutes les propriétés de l’élément spécifié sont retournées. Celles-ci incluent toutes les propriétés définies par l’utilisateur et intégrées qui sont spécifiques à l’élément.

Vous pouvez transmettre le nom complet du chemin d’accès de l’élément pour le Item paramètre ou transmettre l’ID de l’élément. Pour plus d’informations sur l’utilisation des en-têtes SOAP pour ce faire, consultez Utilisation d’en-têtes SOAP Reporting Services.

S’applique à