다음을 통해 공유


ReportingService2010.GetItemParameters 메서드

정의

지정한 항목의 매개 변수 속성을 반환합니다. 이 메서드를 사용하여 지정된 항목의 매개 변수에 대해 매개 변수 값의 유효성을 검사할 수도 있습니다.

public:
 cli::array <ReportService2010::ItemParameter ^> ^ GetItemParameters(System::String ^ ItemPath, System::String ^ HistoryID, bool ForRendering, cli::array <ReportService2010::ParameterValue ^> ^ Values, cli::array <ReportService2010::DataSourceCredentials ^> ^ Credentials);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetItemParameters", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public ReportService2010.ItemParameter[] GetItemParameters (string ItemPath, string HistoryID, bool ForRendering, ReportService2010.ParameterValue[] Values, ReportService2010.DataSourceCredentials[] Credentials);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetItemParameters", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.GetItemParameters : string * string * bool * ReportService2010.ParameterValue[] * ReportService2010.DataSourceCredentials[] -> ReportService2010.ItemParameter[]
Public Function GetItemParameters (ItemPath As String, HistoryID As String, ForRendering As Boolean, Values As ParameterValue(), Credentials As DataSourceCredentials()) As ItemParameter()

매개 변수

ItemPath
String

파일 이름과 SharePoint 모드에서는 확장명을 포함하는 항목의 정규화된 URL입니다.

HistoryID
String

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

ForRendering
Boolean

매개 변수 값의 사용 방법을 나타내는 Boolean 식입니다. 값을 true로 설정하면 항목 실행 도중에 사용된 매개 변수 데이터를 기반으로 매개 변수 속성이 반환됩니다.

Values
ParameterValue[]

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

Credentials
DataSourceCredentials[]

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

반환

항목에 대한 매개 변수를 나열하는 ItemParameter 개체의 배열입니다.

특성

예제

이 코드 예제를 컴파일하려면 Reporting Services WSDL을 참조하고 특정 네임스페이스를 가져와야 합니다. 자세한 내용은 코드 예제 컴파일 및 실행을 참조하세요. 다음 코드 예제에서는 메서드를 GetItemParameters 사용하여 보고서의 매개 변수 메타데이터 목록을 검색한 다음 각 매개 변수의 이름을 표시합니다.

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2010()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Dim report As String = "/SampleReports/Employee Sales Summary"  
      Dim forRendering As Boolean = False  
      Dim historyID As String = Nothing  
      Dim values As ParameterValue() = Nothing  
      Dim credentials As DataSourceCredentials() = Nothing  
      Dim parameters As ItemParameter() = Nothing  

      Try  
         parameters = rs.GetItemParameters(report, historyID, forRendering, values, credentials)  

         If Not (parameters Is Nothing) Then  
            Dim rp As ItemParameter  
            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 'Main  
End Class 'Sample  
using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService2010 rs = new ReportingService2010();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      string report = "/SampleReports/Employee Sales Summary";  
      bool forRendering = false;  
      string historyID = null;  
      ParameterValue[] values = null;  
      DataSourceCredentials[] credentials = null;  
      ItemParameter[] parameters = null;  

      try  
      {  
         parameters = rs.GetItemParameters(report, historyID, forRendering, values, credentials);  

         if (parameters != null)  
         {  
            foreach (ItemParameter rp in parameters)  
            {  
               Console.WriteLine("Name: {0}", rp.Name);  
            }  
         }  
      }  

      catch (SoapException e)  
      {  
         Console.WriteLine(e.Detail.InnerXml.ToString());   
      }  
   }  
}  

설명

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

SOAP 헤더 사용 (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
기본 모드 필수 권한 ReadProperties
SharePoint 모드 필수 권한 <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

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

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

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

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

지정된 항목에 대한 매개 변수가 없으면 빈 ItemParameter 배열이 반환됩니다.

적용 대상