ReportingService2005.GetReportParameters Método

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

Parámetros

Devoluciones

Un array de ReportParameter objetos que lista los parámetros del informe.

Ejemplos

Para compilar este ejemplo de código, debes consultar el WSDL de Reporting Services e importar ciertos espacios de nombres. Para más información, consulte Ejemplos de Compilación y Ejecución de Código. El siguiente ejemplo de código utiliza el GetReportParameters método para obtener una lista de metadatos de parámetros para un informe y luego muestra el nombre de cada parámetro:

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

Comentarios

La siguiente tabla muestra la información sobre cabeceras y permisos sobre esta operación.

Si la configuración de ejecución para el informe es Snapshot, los metadatos del parámetro que se devuelven son los datos que se usaron cuando se creó la instantánea del historial del informe. Si la configuración de ejecución para el informe es Live, los metadatos de parámetros devueltos representan los datos de parámetros asociados al informe especificado.

Si proporcionas un valor para el HistoryID parámetro y lo ForRendering fijas en true, los metadatos del parámetro devueltos representan los datos del parámetro que se usaron cuando se creó la instantánea del historial del informe. El valor proporcionado para HistoryID se ignora si ForRendering se establece en false. Si ForRendering es false, los metadatos de parámetros devueltos representan los datos de parámetros que actualmente están asociados al informe especificado.

Si algún valor de parámetros se basa en una consulta y te interesa devolver la lista de valores válidos de los parámetros de consulta, fija ForRendering en true. Además, para parámetros basados en consultas, debes introducir toda la información de credenciales necesaria para devolver los parámetros de consulta.

Al utilizar el GetReportParameters método para validar parámetros, se requiere el Values parámetro.

Si no existen parámetros de informe para el informe dado, se devuelve un array vacío ReportParameter .