식에서 매개 변수 사용

아티클
12/15/2008

새 설치: 2006년 7월 17일

이 항목에서는 식에서 보고서 매개 변수에 대한 참조를 포함해야 하는 구문의 몇 가지 예를 제공합니다. 보고서 매개 변수는 식에서 참조할 수 있는 전역 컬렉션 중 하나입니다. 자세한 내용은 식에 전역 컬렉션 사용(Reporting Services)을 참조하십시오.

매개 변수는 보고서가 처리될 때 계산됩니다. 식은 (Fx) 또는 <식> 옵션을 제공하는 보고서 항목 속성 또는 텍스트 상자 속성에서 어디서든 사용될 수 있습니다. 식을 사용할 수 있는 위치의 예는 Reporting Services의 식 예를 참조하십시오.

보고서 매개 변수는 다음 유형 중 하나일 수 있습니다. Boolean, DateTime, Integer, Float 또는 String. 보고서 매개 변수는 단일 값 또는 다중값을 가집니다. Boolean을 제외한 모든 유형에 대해 다중값 속성을 설정할 수 있습니다. 다중값 매개 변수는 0부터 시작하는 값 배열입니다. 보고서 속성을 설정하는 방법은 보고서 매개 변수 만들기 및 보고서 매개 변수 속성 설정을 참조하십시오.

단일 값 매개 변수

다음 표에서는 식에서 단일 값 매개 변수를 사용하는 예를 보여 줍니다.

식에서 단일 값 매개 변수 사용

다음 표에서는 식에서 임의 데이터 유형의 단일 값 매개 변수에 대한 참조를 포함할 때 사용할 구문의 예를 보여 줍니다.

예	설명
`=Parameters!`<ParameterName>`.IsMultiValue`	False를 반환합니다. 매개 변수가 다중값인지 확인합니다. True일 경우 매개 변수는 다중값이며 개체 컬렉션입니다. False일 경우 매개 변수는 단일 값이며 단일 개체입니다.
`=Parameters!`<ParameterName>`.Count`	정수 값 1을 반환합니다. 단일 값 매개 변수의 경우 개수는 항상 1입니다.
`=Parameters!`<ParameterName>`.Label`	사용 가능한 값의 드롭다운 목록에서 표시 이름으로 자주 사용되는 매개 변수 레이블을 반환합니다.
`=Parameters!`<ParameterName>`.Value`	매개 변수 값을 반환합니다. 레이블 속성이 설정되지 않았을 경우 이 값은 사용 가능한 값의 드롭다운 목록에 표시됩니다.
`=CStr(Parameters!` <ParameterName>`.Value)`	매개 변수 값을 문자열로 반환합니다.
`=Fields(Parameters!`<ParameterName>`.Value).Value`	매개 변수와 동일한 이름을 갖고 있는 필드에 대해 값을 반환합니다.

단일 값 매개 변수를 사용하여 필터 설정

필터는 데이터 집합, 데이터 영역 또는 데이터 그룹화에 대해 속성 페이지의 필터 탭을 사용하여 설정됩니다. 사용자는 필터 탭의 필터 표에 값을 입력하여 필터 식을 정의합니다. 다음 표는 필터 표를 나타냅니다. 다음 예에서는 Fields!EmployeeID.Value 및 Parameters!EmployeeID.Value의 값이 동일한 데이터 유형이라고 가정합니다.

(필터) 식 연산자 값 및/또는

(필터) 식	연산자	값	및/또는
`= Fields!`<FieldName>`.Value`	값을 서로 비교하는 임의 연산자. 예를 들면 다음과 같습니다. = >= <	`=Parameters!`<ParameterName>`.Value`	둘 이상의 식을 입력할 때 활성화되는 미리 설정된 값.

= Fields!<FieldName>.Value

값을 서로 비교하는 임의 연산자. 예를 들면 다음과 같습니다.

=Parameters!<ParameterName>.Value

둘 이상의 식을 입력할 때 활성화되는 미리 설정된 값.

다중 값 매개 변수

다음 표에서는 식에서 다중값 매개 변수를 사용하는 예를 보여 줍니다.

식에서 다중값 매개 변수 사용

식은 (Fx) 또는 <식> 옵션을 제공하는 보고서 항목 속성 또는 텍스트 상자 속성에서 어디서든 사용될 수 있습니다.

예	설명
`=Parameters!`<MultivalueParameterName>`.IsMultiValue`	True 또는 False를 반환합니다. 매개 변수가 다중값인지 확인합니다. True일 경우 매개 변수는 다중값이며 개체 컬렉션입니다. False일 경우 매개 변수는 단일 값이며 단일 개체입니다.
`=Parameters!`<MultivalueParameterName>`.Count`	정수 값을 반환합니다. 값 개수를 나타냅니다. 단일 값 매개 변수의 경우 개수는 항상 1입니다. 다중값 매개 변수의 경우 개수는 0 이상입니다.
`=Parameters!`<MultivalueParameterName>`.Value(0)`	다중값 매개 변수의 첫 번째 값을 반환합니다.
`=Parameters!`<MultivalueParameterName>`.Value(Parameters!`<MultivalueParameterName>`.Count-1)`	다중값 매개 변수의 마지막 값을 반환합니다.
`=Split("Value1,Value2,Value3",",")`	값 배열을 반환합니다. 다중값 문자열 매개 변수에 대한 값 배열을 만듭니다. 분할할 두 번째 매개 변수에서 임의의 구분 기호를 사용할 수 있습니다. 다중값 매개 변수에 대한 기본값을 설정하거나, 포함된 보고서 또는 드릴스루 보고서에 전송할 다중값 매개 변수를 만드는 데 이 식을 사용할 수 있습니다.
`=Join(Parameters!`<MultivalueParameterName>`.Value,", ")`	다중값 매개 변수에서 쉼표로 구분된 값 목록으로 구성된 문자열을 반환합니다. 조인할 두 번째 매개 변수에서 임의의 구분 기호를 사용할 수 있습니다.

다중값 매개 변수를 사용하여 필터 설정

필터는 데이터 집합, 데이터 영역 또는 데이터 그룹화에 대해 속성 페이지의 필터 탭을 사용하여 설정됩니다. 다음 예에서는 Fields!EmployeeID.Value 및 Parameters!EmployeeID.Value의 값이 동일한 데이터 유형이라고 가정합니다. 다중값 매개 변수는 값 열에만 표시될 수 있습니다.

식	연산자	값	및/또는
`= Fields!`<FieldName>`.Value`	집합 포함을 테스트하는 연산자. 선택할 수 있는 유일한 값: `IN`	`=Parameters!`<MultivalueParameterName>`.Value`	둘 이상의 식을 입력할 때 설정되는 미리 설정된 값.

사용자 지정 코드의 매개 변수 참조의 예

보고서 정의의 코드 블록 또는 사용자가 제공하는 사용자 지정 어셈블리에서 사용자 지정 코드를 통해 전역 매개 변수 컬렉션을 참조할 수 있습니다. 매개 변수 컬렉션은 읽기 전용이며 공개 반복기는 없습니다. Visual Basic For Each 구조를 사용하여 컬렉션을 단계별로 실행할 수 없습니다. 보고서 정의에 정의된 매개 변수 이름을 알아야 사용자의 코드에서 해당 매개 변수를 참조할 수 있습니다. 하지만 다중값 매개 변수의 모든 값을 반복할 수 있습니다. 자세한 내용은 식에 사용자 지정 코드 참조 사용(Reporting Services)을 참조하십시오.

설명 식에서의 참조 사용자 지정 코드 정의

설명	식에서의 참조	사용자 지정 코드 정의
전체 전역 매개 변수 컬렉션을 사용자 지정 코드에 전달. 이 함수는 특정 보고서 매개 변수 MyParameter의 값을 반환합니다.	`=Code.DisplayAParameterValue(Parameters)`	`Public Function DisplayAParameterValue(` `ByVal parameters as Parameters) as Object` `Return parameters("MyParameter").Value` `End Function`
개별 매개 변수를 사용자 지정 코드에 전달. 이 예에서는 전달된 매개 변수의 값을 반환합니다. 매개 변수가 다중값 매개 변수일 경우 반환 문자열은 모든 값의 연결입니다.	`=Code.ShowParametersValues(Parameters!DayOfTheWeek)`	`Public Function ShowParameterValues(ByVal parameter as Parameter) as String Dim s as String If parameter.IsMultiValue then s = "Multivalue: " For i as integer = 0 to parameter.Count-1 s = s + CStr(parameter.Value(i)) + " " Next Else s = "Single value: " + CStr(parameter.Value) End If Return s End Function`

전체 전역 매개 변수 컬렉션을 사용자 지정 코드에 전달. 이 함수는 특정 보고서 매개 변수 MyParameter의 값을 반환합니다.

=Code.DisplayAParameterValue(Parameters)

Public Function DisplayAParameterValue(

ByVal parameters as Parameters) as Object

Return parameters("MyParameter").Value

End Function

개별 매개 변수를 사용자 지정 코드에 전달. 이 예에서는 전달된 매개 변수의 값을 반환합니다. 매개 변수가 다중값 매개 변수일 경우 반환 문자열은 모든 값의 연결입니다.

=Code.ShowParametersValues(Parameters!DayOfTheWeek)

Public Function ShowParameterValues(ByVal parameter as Parameter)
 as String
   Dim s as String 
   If parameter.IsMultiValue then
      s = "Multivalue: " 
      For i as integer = 0 to parameter.Count-1
         s = s + CStr(parameter.Value(i)) + " " 
      Next
   Else
      s = "Single value: " + CStr(parameter.Value)
   End If
   Return s
End Function

참고 항목