ReportExecutionService.SetExecutionParameters(ParameterValue[], String) ReportExecutionService.SetExecutionParameters(ParameterValue[], String) ReportExecutionService.SetExecutionParameters(ParameterValue[], String) Method

정의

현재 보고서 실행과 연결된 매개 변수 값을 설정하고 유효성을 검사합니다. Sets and validates parameter values associated with the current report execution.

public:
 ReportExecution2005::ExecutionInfo ^ SetExecutionParameters(cli::array <ReportExecution2005::ParameterValue ^> ^ Parameters, System::String ^ ParameterLanguage);
public ReportExecution2005.ExecutionInfo SetExecutionParameters (ReportExecution2005.ParameterValue[] Parameters, string ParameterLanguage);
Public Function SetExecutionParameters (Parameters As ParameterValue(), ParameterLanguage As String) As ExecutionInfo
매개 변수
Parameters
ParameterValue[]

배열 ParameterValue 개체입니다. An array of ParameterValue objects.

ParameterLanguage
String String String

.NET Framework 로캘 식별자입니다. A .NET Framework locale identifier.

반환

ExecutionInfo 새 실행을 포함 하는 개체입니다. An ExecutionInfo object containing the new execution.

설명

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

SOAP 헤더 사용SOAP Header Usage (In) TrustedUserHeaderValue(In) TrustedUserHeaderValue

(In) ExecutionHeaderValue(In) ExecutionHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
기본 모드에 필요한 권한Native Mode Required Permissions 주 보고서와 모든 하위 보고서에: ReadProperties AND ExecuteAndViewOn the main report and all subreports: ReadProperties AND ExecuteAndView
SharePoint 모드에 필요한 권한SharePoint Mode Required Permissions 주 보고서 및 모든 하위 보고서의 경우: ViewListItemsOn the main report and all subreports: ViewListItems

스냅숏이 현재 실행에 있으면 매개 변수 값을 설정 하는 경우 실행 또는 있어야만 파일에 다시 실행 되도록 보고서 기록 스냅숏을 포함 되지 않은 경우 지워집니다.If a snapshot exists in the current execution when the parameter values are set, it will be cleared if it is not an execution or a history snapshot, which will require the report to be executed again. 실행 하거나 기록 스냅숏을 쿼리가 아닌 매개 변수 값을 지정할 수 있습니다.For execution or history snapshots, you can specify values for non-query parameters. 참고 보고서 서버 실행 또는 기록 스냅숏에 대 한 데이터 처리를 수행 하지 않습니다.Note the report server does not perform data processing for execution or history snapshots.

사용자가 지정한 매개 변수 값 유형이 잘못 되었습니다, 오류 및 매개 변수 변경 되지 않습니다 메서드가 반환 됩니다.If the parameter value you specify has an incorrect type, the method will return an error and the parameter is not changed. 매개 변수 값에 올바른 형식 이지만 잘못 된 값을 매개 변수 입력은 MissingValidValue 상태입니다.If the parameter value has the correct type, but is not a valid value, the parameter enters the MissingValidValue state. 두 경우 모두 보고서를 렌더링 하는 동안 오류가 발생 합니다.In both cases, attempting to render the report will cause an error.

경우 ParameterLanguage 를 지정 하지 않으면에 지정 된 언어는 Accepts-Language HTTP 헤더입니다.If ParameterLanguage is not specified, the language specified in the Accepts-Language HTTP header. 에 대해 지정 되지 않은 경우는 Accepts-Language HTTP 헤더, 보고서 서버의 기본 언어를 사용 합니다.If no language is specified for the Accepts-Language HTTP header, the default language on the report server is used.

적용 대상