ReportingService2006.GetReportParameters Méthode

Définition

Retourne des propriétés de paramètre de rapport pour un rapport spécifié. La méthode GetReportParameters(String, String, ParameterValue[], DataSourceCredentials[]) peut également être utilisée pour valider des valeurs de paramètre d'après les paramètres d'un rapport spécifié.

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

Paramètres

Report
String

URL complète du rapport, y compris le nom de fichier et l'extension de nom de fichier .rdl.

HistoryID
String

ID de l'instantané d'historique de rapport. Définissez le ForRendering paramètre sur une valeur de afin de récupérer les propriétés de true paramètre d’un instantané d’historique de rapport. Affectez une null (Nothing en Visual Basic) si vous récupérez des paramètres pour un rapport qui n'est pas un instantané d'historique de rapport.

Values
ParameterValue[]

Valeurs de paramètre (objets ParameterValue) qui peuvent être validées d'après les paramètres d'un rapport.

Credentials
DataSourceCredentials[]

Informations d'identification de source de données (objets DataSourceCredentials) qui peuvent être utilisées pour valider les paramètres de requête.

Retours

Tableau d'objets ReportParameter qui répertorie les paramètres pour le rapport.

Exemples

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  

Remarques

Le tableau suivant présente les informations relatives aux en-têtes et aux autorisations sur cette opération.

En-têtes SOAP (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
Autorisations requises <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Si le paramètre d’exécution du rapport est Snapshot, les métadonnées de paramètre retournées sont les données utilisées lors de la création de l’historique du rapport instantané. Si le paramètre d’exécution du rapport est Live, les métadonnées de paramètre retournées représentent les données de paramètre associées au rapport spécifié.

Si vous fournissez une valeur pour le HistoryID paramètre et que vous définissez la valeur du ForRendering paramètre sur true, les métadonnées de paramètre retournées représentent les données de paramètre qui ont été utilisées lors de la création de l’instantané d’historique de rapport. La valeur fournie pour HistoryID est ignorée si ForRendering a la valeur false. Si ForRendering a la valeur false, les métadonnées de paramètre retournées représentent les données de paramètre actuellement associées au rapport spécifié.

Si des valeurs de paramètres sont basées sur une requête et que vous souhaitez retourner la liste des valeurs valides des paramètres basés sur la requête, définissez ForRendering sur true. En outre, pour les paramètres basés sur une requête, vous devez transmettre toutes les informations d’identification requises pour retourner les paramètres de requête.

Lorsque vous utilisez la GetReportParameters méthode pour valider des paramètres, le Values paramètre est obligatoire.

Si les paramètres de rapport n’existent pas pour le rapport donné, un tableau vide ReportParameter est retourné.

S’applique à