ReportingService2006.GetReportParameters Methode

Definition

Gibt Berichtsparametereigenschaften für einen angegebenen Bericht zurück. Die GetReportParameters(String, String, ParameterValue[], DataSourceCredentials[])-Methode kann auch verwendet werden, um Parameterwerte anhand von Parametern für einen angegebenen Bericht zu validieren.

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

Parameter

Report
String

Die vollqualifizierte URL des Berichts einschließlich des Dateinamens und der Dateinamenerweiterung (.rdl).

HistoryID
String

Die ID der Berichtsverlaufs-Momentaufnahme. Legen Sie den ForRendering Parameter auf einen Wert von true fest, um Parametereigenschaften für einen Berichtsverlauf Momentaufnahme abzurufen. Legen Sie den Wert auf null (Nothing in Visual Basic) fest, wenn Sie Parameter für einen Bericht abrufen, der keine Berichtsverlaufs-Momentaufnahme ist.

Values
ParameterValue[]

Die Parameterwerte (ParameterValue-Objekte), die für die Parameter eines Berichts validiert werden können.

Credentials
DataSourceCredentials[]

Die Anmeldeinformationen für die Datenquelle (DataSourceCredentials-Objekte), mit denen Abfrageparameter validiert werden können.

Gibt zurück

Ein Array von ReportParameter-Objekten, das die Parameter für den Bericht aufführt.

Beispiele

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  

Hinweise

In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.

SOAP-Header (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
Erforderliche Berechtigungen <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Wenn die Ausführungseinstellung für den Bericht lautetSnapshot, sind die zurückgegebenen Parametermetadaten die Daten, die beim Erstellen des Berichtsverlaufs Momentaufnahme verwendet wurden. Wenn die Ausführungseinstellung für den Bericht lautet Live, stellen die zurückgegebenen Parametermetadaten die Parameterdaten dar, die dem angegebenen Bericht zugeordnet sind.

Wenn Sie einen Wert für den HistoryID Parameter angeben und den ForRendering Parameterwert auf truefestlegen, stellen die zurückgegebenen Parametermetadaten die Parameterdaten dar, die beim Erstellen des Berichtsverlaufs Momentaufnahme verwendet wurden. Der für HistoryID angegebene Wert wird ignoriert, wenn ForRendering auf falsefestgelegt ist. Wenn ForRendering ist false, stellen die zurückgegebenen Parametermetadaten die Parameterdaten dar, die derzeit dem angegebenen Bericht zugeordnet sind.

Wenn Parameterwerte auf einer Abfrage basieren und Sie daran interessiert sind, die Liste der gültigen Werte der abfragebasierten Parameter zurückzugeben, legen Sie auf fest ForRenderingtrue. Darüber hinaus müssen Sie für abfragebasierte Parameter alle Anmeldeinformationen übergeben, die zum Zurückgeben der Abfrageparameter erforderlich sind.

Wenn Sie die -Methode zum Überprüfen von GetReportParameters Parametern verwenden, ist der Values Parameter erforderlich.

Wenn für den angegebenen Bericht keine Berichtsparameter vorhanden sind, wird ein leeres ReportParameter Array zurückgegeben.

Gilt für: