ReportingService2005.GetReportParameters Metodo

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

Valori restituiti

Un array di ReportParameter oggetti che elenca i parametri per il report.

Esempio

Per compilare questo esempio di codice, devi fare riferimento al WSDL di Reporting Services e importare determinati namespace. Per maggiori informazioni, vedi Compiling and Conducting Code Examples. Il seguente esempio di codice utilizza il GetReportParameters metodo per recuperare una lista di metadati dei parametri di un report e poi mostra il nome di ciascun 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

La tabella sottostante mostra informazioni sull'intestazione e sui permessi di questa operazione.

Se l'impostazione di esecuzione per il report è Snapshot, i metadati del parametro restituiti sono i dati utilizzati quando è stata creata l'istantanea 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 fornisci un valore per il HistoryID parametro e imposti il ForRendering valore del parametro a true, i metadati del parametro restituiti rappresentano i dati dei parametri utilizzati quando è stata creata l'istantanea della cronologia del report. Il valore fornito per HistoryID è ignorato se ForRendering è impostato a false. Se ForRendering è false, i metadati dei parametri restituiti rappresentano i dati dei parametri attualmente associati al report specificato.

Se qualche valore di parametro si basa su una query e sei interessato a restituire la lista dei valori validi dei parametri basati sulla query, imposta ForRendering a true. Inoltre, per i parametri basati su query, devi inserire tutte le informazioni sulle credenziali necessarie per restituire i parametri della query.

Quando si utilizza il GetReportParameters metodo per validare i parametri, il Values parametro è richiesto.

Se i parametri del report non esistono per il report dato, viene restituito un array vuoto ReportParameter .