ReportingService2006.GetReportParameters 메서드

정의

네임스페이스:

ReportService2006

어셈블리:

ReportService2006.dll

지정된 보고서에 대한 보고서 매개 변수 속성을 반환합니다. GetReportParameters(String, String, ParameterValue[], DataSourceCredentials[]) 메서드를 사용하여 지정된 보고서의 매개 변수에 대해 매개 변수 값의 유효성을 검사할 수도 있습니다.

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

매개 변수

Report

String

파일 이름과 .rdl 파일 이름 확장명을 포함하는 보고서의 정규화된 URL입니다.

HistoryID

String

보고서 기록 스냅샷의 ID입니다. ForRendering 보고서 기록 스냅샷 대한 매개 변수 속성을 검색하려면 매개 변수를 값 true 으로 설정합니다. 보고서 기록 스냅숏이 아닌 보고서에 대해 매개 변수를 검색하려면 이 값을 null(Visual Basic의 경우 Nothing)로 설정합니다.

Values

ParameterValue[]

보고서의 매개 변수에 대해 유효성을 검사할 수 있는 매개 변수 값(ParameterValue 개체)입니다.

Credentials

DataSourceCredentials[]

쿼리 매개 변수의 유효성을 검사하는 데 사용할 수 있는 데이터 원본 자격 증명(DataSourceCredentials 개체)입니다.

반환

ReportParameter[]

보고서에 대한 매개 변수를 나열하는 ReportParameter 개체의 배열입니다.

예제

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  

설명

다음 표에서는 이 작업에 대한 헤더 및 사용 권한 정보를 보여 줍니다.

SOAP 헤더	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
필요한 권한	<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

보고서에 대한 실행 설정이 Snapshot이면 반환되는 매개 변수 메타데이터는 보고서 기록 스냅샷 만들 때 사용된 데이터입니다. 보고서에 대한 실행 설정이 Live이면 반환된 매개 변수 메타데이터는 지정된 보고서와 연결된 매개 변수 데이터를 나타냅니다.

매개 변수에 대한 HistoryID 값을 제공하고 매개 변수 값을 로 true설정 ForRendering 하면 반환된 매개 변수 메타데이터는 보고서 기록 스냅샷 만들 때 사용된 매개 변수 데이터를 나타냅니다. 에 제공 HistoryID 된 값은 가 로 설정된 false경우 ForRendering 무시됩니다. 가 이false면 ForRendering 반환된 매개 변수 메타데이터는 현재 지정된 보고서와 연결된 매개 변수 데이터를 나타냅니다.

쿼리를 기반으로 하는 매개 변수 값이 있고 쿼리 기반 매개 변수의 유효한 값 목록을 반환하려는 경우 를 로 설정합니다 ForRenderingtrue. 또한 쿼리 기반 매개 변수의 경우 쿼리 매개 변수를 반환하는 데 필요한 모든 자격 증명 정보를 전달해야 합니다.

메서드를 GetReportParameters 사용하여 매개 변수의 유효성을 검사하는 경우 매개 변수가 Values 필요합니다.

지정된 보고서에 대한 보고서 매개 변수가 없으면 빈 ReportParameter 배열이 반환됩니다.