ReportingService2010.GetItemParameters 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정한 항목의 매개 변수 속성을 반환합니다. 이 메서드를 사용하여 지정된 항목의 매개 변수에 대해 매개 변수 값의 유효성을 검사할 수도 있습니다.
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
무시됩니다. 가 이false
면 ForRendering
반환된 매개 변수 메타데이터는 현재 지정된 항목과 연결된 매개 변수 데이터를 나타냅니다.
쿼리를 기반으로 하는 매개 변수 값이 있고 쿼리 기반 매개 변수의 유효한 값 목록을 반환하려는 경우 를 로 설정합니다 ForRendering
true
. 또한 쿼리 기반 매개 변수의 경우 쿼리 매개 변수를 반환하는 데 필요한 모든 자격 증명 정보를 전달해야 합니다.
메서드를 GetItemParameters 사용하여 매개 변수의 유효성을 검사하는 경우 매개 변수가 Values
필요합니다.
지정된 항목에 대한 매개 변수가 없으면 빈 ItemParameter 배열이 반환됩니다.