ReportingService2005.GetReportParameters Metodo

Definizione

Spazio dei nomi:

ReportService2005

Assembly:

ReportService2005.dll

Restituisce le proprietà dei parametri dei report per un report specificato. Il metodo GetReportParameters(String, String, Boolean, ParameterValue[], DataSourceCredentials[]) può essere utilizzato anche per convalidare i valori dei parametri rispetto ai parametri di un report specificato.

public:
 cli::array <ReportService2005::ReportParameter ^> ^ GetReportParameters(System::String ^ Report, System::String ^ HistoryID, bool ForRendering, cli::array <ReportService2005::ParameterValue ^> ^ Values, cli::array <ReportService2005::DataSourceCredentials ^> ^ Credentials);

public ReportService2005.ReportParameter[] GetReportParameters (string Report, string HistoryID, bool ForRendering, ReportService2005.ParameterValue[] Values, ReportService2005.DataSourceCredentials[] Credentials);

member this.GetReportParameters : string * string * bool * ReportService2005.ParameterValue[] * ReportService2005.DataSourceCredentials[] -> ReportService2005.ReportParameter[]

Public Function GetReportParameters (Report As String, HistoryID As String, ForRendering As Boolean, Values As ParameterValue(), Credentials As DataSourceCredentials()) As ReportParameter()

Parametri

Report

String

Nome e percorso completo del report.

HistoryID

String

ID dello snapshot della cronologia del report. Impostare il ForRendering parametro su un valore di per recuperare le proprietà dei true parametri per uno snapshot della cronologia del report. Impostare il valore su null (Nothing in Visual Basic) se si recuperano parametri per un report che non rappresenta uno snapshot della cronologia del report.

ForRendering

Boolean

Espressione Boolean che indica come devono essere utilizzati i valori del parametro. Se impostata sul valore true, le proprietà restituite dei parametri si basano sui dati dei parametri utilizzati durante l'esecuzione del report.

Values

ParameterValue[]

Valori dei parametri (oggettiParameterValue ) che possono essere convalidati rispetto ai parametri di un report gestito dal server di report.

Credentials

DataSourceCredentials[]

Credenziali per l'origine dati (oggettiDataSourceCredentials) che possono essere utilizzate per convalidare i parametri delle query.

Restituisce

ReportParameter[]

Matrice di oggetti ReportParameter in cui sono elencati i parametri per il report.

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 utilizzato il GetReportParameters metodo per recuperare un elenco di metadati dei parametri per un report e quindi viene visualizzato il nome di ogni parametro:

Imports System  
Imports System.Web.Services.Protocols  

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

      Dim report As String = "/SampleReports/Employee Sales Summary"  
      Dim forRendering As Boolean = False  
      Dim historyID As String = Nothing  
      Dim values As ParameterValue() = Nothing  
      Dim credentials As DataSourceCredentials() = Nothing  
      Dim parameters As ReportParameter() = Nothing  

      Try  
         parameters = rs.GetReportParameters(report, historyID, forRendering, values, credentials)  

         If Not (parameters Is Nothing) Then  
            Dim rp As ReportParameter  
            For Each rp In parameters  
               Console.WriteLine("Name: {0}", rp.Name)  
            Next rp  
         End If  

      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;  

      string report = "/SampleReports/Employee Sales Summary";  
      bool forRendering = false;  
      string historyID = null;  
      ParameterValue[] values = null;  
      DataSourceCredentials[] credentials = null;  
      ReportParameter[] parameters = null;  

      try  
      {  
         parameters = rs.GetReportParameters(report, historyID, forRendering, values, credentials);  

         if (parameters != null)  
         {  
            foreach (ReportParameter rp in parameters)  
            {  
               Console.WriteLine("Name: {0}", rp.Name);  
            }  
         }  
      }  

      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	(Out) ServerInfoHeaderValue
Autorizzazioni necessarie	ReadProperties

Se l'impostazione di esecuzione per il report è Snapshot, i metadati dei parametri restituiti sono i dati usati quando è stato creato lo snapshot della cronologia del report. Se l'impostazione di esecuzione per il report è Live, i metadati dei parametri restituiti rappresentano i dati dei parametri associati al report specificato.

Se si specifica un valore per il HistoryID parametro e si imposta il valore del ForRendering parametro su true, i metadati dei parametri restituiti rappresentano i dati dei parametri usati quando è stato creato lo snapshot della cronologia del report. Il valore fornito per HistoryID viene ignorato se ForRendering è impostato su false. Se ForRendering è false, i metadati dei parametri restituiti rappresentano i dati dei parametri attualmente associati al report specificato.

Se i valori dei parametri sono basati su una query e si è interessati a restituire l'elenco di valori validi dei parametri basati su query, impostare su ForRenderingtrue. Inoltre, per i parametri basati su query, è necessario passare tutte le informazioni sulle credenziali necessarie per restituire i parametri di query.

Quando si usa il GetReportParameters metodo per convalidare i parametri, è necessario il Values parametro .

Se i parametri del report non esistono per il report specificato, viene restituita una matrice vuota ReportParameter .