ReportingService2006.GetReportParameters(String, String, ParameterValue[], DataSourceCredentials[]) ReportingService2006.GetReportParameters(String, String, ParameterValue[], DataSourceCredentials[]) ReportingService2006.GetReportParameters(String, String, ParameterValue[], DataSourceCredentials[]) Method

정의

지정된 보고서에 대한 보고서 매개 변수 속성을 반환합니다. Returns report parameter properties for a specified report. GetReportParameters(String, String, ParameterValue[], DataSourceCredentials[]) 메서드 지정된 된 보고서의 매개 변수에 대해 매개 변수 값의 유효성 검사를 사용할 수도 있습니다. The GetReportParameters(String, String, ParameterValue[], DataSourceCredentials[]) method can also be used to validate parameter values against parameters for a specified report.

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);
Public Function GetReportParameters (Report As String, HistoryID As String, Values As ParameterValue(), Credentials As DataSourceCredentials()) As ReportParameter()
매개 변수
Report
String String String

파일 이름과 .rdl 파일 이름 확장명을 포함하는 보고서의 정규화된 URL입니다. The fully qualified URL of the report including the file name and .rdl file name extension.

HistoryID
String String String

보고서 기록 스냅숏의 ID입니다. The ID of the report history snapshot. 설정의 ForRendering 매개 변수 값의 true 보고서 기록 스냅숏에 대 한 매개 변수 속성을 검색 하려면. Set the ForRendering parameter to a value of true in order to retrieve parameter properties for a report history snapshot. 보고서 기록 스냅숏이 아닌 보고서에 대해 매개 변수를 검색하려면 이 값을 null(Visual Basic의 경우 Nothing)로 설정합니다. Set the value to null (Nothing in Visual Basic) if you are retrieving parameters for a report that is not a report history snapshot.

Values
ParameterValue[]

매개 변수 값 (ParameterValue 개체)는 보고서의 매개 변수에 대해 검사할 수 있습니다. The parameter values (ParameterValue objects) that can be validated against the parameters of a report.

Credentials
DataSourceCredentials[]

쿼리 매개 변수의 유효성을 검사하는 데 사용할 수 있는 데이터 원본 자격 증명(DataSourceCredentials 개체)입니다. The data source credentials (DataSourceCredentials objects) that can be used to validate query parameters.

반환

보고서에 대한 매개 변수를 나열하는 ReportParameter 개체의 배열입니다. An array of ReportParameter objects that lists the parameters for the report.

예제

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  

설명

다음 표에서는 이 작업에 대한 헤더 및 사용 권한 정보를 보여 줍니다.The table below shows header and permissions information on this operation.

SOAP 헤더SOAP Headers (In) TrustedUserHeaderValue(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
필요한 권한Required Permissions ViewListItems

보고서에 대 한 실행 설정이 Snapshot, 반환 되는 매개 변수 메타 데이터는 보고서 기록 스냅숏을 만들 때 사용 된 데이터입니다.If the execution setting for the report is Snapshot, the parameter metadata that is returned is the data that was used when the report history snapshot was created. 보고서에 대 한 실행 설정이 Live, 매개 변수 메타 데이터가 지정된 된 보고서와 연결 된 매개 변수 데이터를 나타내는 반환 합니다.If the execution setting for the report is Live, the parameter metadata returned represents the parameter data that is associated with the specified report.

에 대 한 값을 제공 하는 경우는 HistoryID 집합과, 매개 변수는 ForRendering 매개 변수 값을 true, 매개 변수 메타 데이터 반환 보고서 기록 스냅숏을 만들 때 사용 했던 매개 변수 데이터를 나타냅니다.If you provide a value for the HistoryID parameter and set the ForRendering parameter value to true, the parameter metadata returned represents the parameter data that was used when the report history snapshot was created. 제공 된 값 HistoryID 경우 무시 됩니다 ForRendering 로 설정 된 false합니다.The value supplied for HistoryID is ignored if ForRendering is set to false. 경우 ForRenderingfalse, 매개 변수 메타 데이터가 지정 된 보고서와 함께 현재 연결 되어 있는 매개 변수 데이터를 나타내는 반환 합니다.If ForRendering is false, the parameter metadata returned represents the parameter data that is currently associated with the specified report.

모든 매개 변수 값은 기반으로 하는 경우 쿼리의 쿼리 기반 매개 변수 유효한 값 목록을 반환 관심 있는, 설정 ForRenderingtrue합니다.If any parameters values are based on a query and you are interested in returning the query-based parameters' valid values list, set ForRendering to true. 또한 쿼리 기반 매개 변수를 전달 해야 하는 쿼리 매개 변수를 반환 하는 데 필요한 모든 자격 증명 정보.In addition, for query-based parameters, you must pass in all the credential information that is required to return the query parameters.

사용 하는 경우는 GetReportParameters 매개 변수 유효성을 검사 하는 메서드는 Values 매개 변수는 필수입니다.When using the GetReportParameters method to validate parameters, the Values parameter is required.

보고서 매개 변수는 빈 지정된 된 보고서에 대 한 존재 하지 않는 경우 ReportParameter 배열이 반환 됩니다.If report parameters do not exist for the given report, an empty ReportParameter array is returned.

적용 대상