ReportingService2005.GetProperties(String, Property[]) Méthode
Définition
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.
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.