ReportingService2006.GetReportParameters Método

Definición

Espacio de nombres:

ReportService2006

Ensamblado:

ReportService2006.dll

Devuelve las propiedades de los parámetros de informe para un informe especificado. El método GetReportParameters(String, String, ParameterValue[], DataSourceCredentials[]) también se puede usar para validar los valores de parámetro con los parámetros de un informe especificado.

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

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

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

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

Parámetros

Report

String

Dirección URL completa del informe, incluidos el nombre y la extensión de nombre de archivo .rdl.

HistoryID

String

Identificador de la instantánea del historial de informes. Establezca el ForRendering parámetro en un valor de para recuperar las propiedades de true parámetro de una instantánea del historial de informes. Establezca el valor en null (Nothing en Visual Basic) si va a recuperar los parámetros para un informe que no sea una instantánea del historial de informes.

Values

ParameterValue[]

Valores de los parámetros (objetosParameterValue ) que se pueden validar con los parámetros de un informe.

Credentials

DataSourceCredentials[]

Credenciales del origen de datos (objetosDataSourceCredentials) que se pueden utilizar para validar los parámetros de la consulta.

Devoluciones

ReportParameter[]

Matriz de objetos ReportParameter que enumeran los parámetros para el informe.

Ejemplos

using System;  
using System.Collections.Generic;  
using System.IO;  
using System.Text;  
using System.Web;  
using System.Web.Services;  
using System.Web.Services.Protocols;  

class Sample  
{  
    static void Main(string[] args)  
    {  
        ReportingService2006 rs = new ReportingService2006();  
        rs.Url = "http://<Server Name>/_vti_bin/ReportServer/" +  
            "ReportService2006.asmx";  
        rs.Credentials =   
            System.Net.CredentialCache.DefaultCredentials;  

        string report = "http://<Server Name>/Docs/Documents" +  
            "/AdventureWorks Sample Reports/" +  
            "Employee Sales Summary.rdl";  
        string historyID = null;  
        ParameterValue[] values = null;  
        DataSourceCredentials[] credentials = null;  
        ReportParameter[] parameters = null;  

        try  
        {  
            parameters = rs.GetReportParameters(report, historyID,   
                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());  
        }  
    }  
}  

Imports System  
Imports System.IO  
Imports System.Text  
Imports System.Web.Services  
Imports System.Web.Services.Protocols  

Class Sample  

    Public Shared Sub Main()  

        Dim rs As New ReportingService2006()  
        rs.Url = "http://<Server Name>/_vti_bin/" + _  
            "ReportServer/ReportService2006.asmx"  
        rs.Credentials = _  
            System.Net.CredentialCache.DefaultCredentials  

        Dim report As String = "http://<Server Name>" + _  
            "/Docs/Documents/AdventureWorks Sample Reports" + _  
            "/Employee Sales Summary.rdl"  
        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, _  
                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  

End Class  

Comentarios

En la siguiente tabla se muestra la información de encabezado y de permisos de esta operación.

Encabezados SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Permisos necesarios	<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

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

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

Si los valores de parámetros se basan en una consulta y está interesado en devolver la lista de valores válidos de los parámetros basados en consultas, establezca en ForRenderingtrue. Además, para los parámetros basados en consultas, debe pasar toda la información de credenciales necesaria para devolver los parámetros de consulta.

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

Si los parámetros de informe no existen para el informe determinado, se devuelve una matriz vacía ReportParameter .