ReportingService2005.GetProperties(String, Property[]) Metodo

Definizione

Restituisce il valore di una o più proprietà di un elemento nel database del server di report.

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

Parametri

Item
String

Nome e percorso completo o ID dell'elemento.

Properties
Property[]

Matrice di oggetti Property contenente le proprietà per le quali si desidera recuperare i valori.

Restituisce

Matrice di oggetti Property che rappresenta le proprietà dell'elemento specificato.

Esempio

Per compilare questo esempio di codice, è necessario fare riferimento alla Reporting Services WSDL e importare determinati spazi dei nomi. Per altre informazioni, vedere Compilazione ed esecuzione di esempi di codice. Nell'esempio di codice seguente viene usato il GetProperties metodo per recuperare la descrizione associata al report Company Sales:

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

Commenti

Nella tabella seguente vengono mostrate le informazioni sull'intestazione e sulle autorizzazioni relative a questa operazione.

Intestazioni SOAP (In) ItemNamespaceHeaderValue

(Out) ServerInfoHeaderValue
Autorizzazioni necessarie Dipende dal tipo di elemento:

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

Il valore predefinito che deve essere passato per questo argomento è il nome completo del percorso. Per specificare un ID, è necessario impostare l'intestazione ItemNamespaceHeader SOAP. Per altre informazioni, vedere Impostazione dello spazio dei nomi item per il metodo GetProperties.

Usare il metodo per recuperare il GetProperties set completo di proprietà definite dall'utente e riservate. Per recuperare il subset standard di proprietà riservate, usare il ListChildren metodo . Per un elenco delle proprietà riservate degli elementi nel database del server di report, vedere Proprietà elemento del server di report.

Se il Properties parametro è null (Nothing in Visual Basic), vengono restituite tutte le proprietà per l'elemento specificato. Includono tutte le proprietà definite dall'utente e predefinite specifiche per l'elemento.

È possibile passare il nome completo del percorso dell'elemento per il Item parametro oppure passare l'ID dell'elemento. Per altre informazioni sull'uso di intestazioni SOAP per eseguire questa operazione, vedere Uso di Reporting Services intestazioni SOAP.

Si applica a