Langue

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

Le nom complet du chemin ou l’ID de l’objet.

Properties
Property[]

Un tableau d’objets Property contenant les propriétés pour lesquelles vous souhaitez récupérer les valeurs.

Retours

Un 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 WSDL de Reporting Services et importer certains espaces de noms. Pour plus d’informations, voir Exemples de compilation et exécution de code. L’exemple de code suivant utilise la GetProperties méthode pour récupérer la description associée au rapport de ventes de l’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 ci-dessous présente les informations sur l’en-tête et les autorisations concernant cette opération.

En-têtes SOAP (En) ItemNamespaceHeaderValue

(Dehors) ServerInfoHeaderValue
Autorisations requises Cela dépend du type d’objet :

- 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 complet du chemin. Pour fournir un identifiant, vous devez définir l’en-tête ItemNamespaceHeader SOAP. Pour plus d’informations, voir Définir l’espace de noms des éléments pour la méthode GetProperties.

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

Si le Properties paramètre est null (Nothing dans Visual Basic), toutes les propriétés de l’élément spécifié sont renvoyées. Cela inclut toutes les propriétés définies par l’utilisateur et intégrées spécifiques à l’article.

Vous pouvez passer le nom complet du chemin de l’élément pour le Item paramètre ou passer l’ID de l’élément. Pour plus d’informations sur l’utilisation des en-têtes SOAP à cet effet, voir Utilisation des en-têtes SOAP de Reporting Services.

S’applique à