식에서 매개 변수 컬렉션 참조 사용(보고서 작성기 2.0)
보고서 매개 변수는 식에서 참조할 수 있는 기본 제공 컬렉션 중 하나입니다. 식에 매개 변수를 포함하면 사용자의 선택에 따라 보고서 데이터와 모양을 사용자 지정할 수 있습니다. 식은 (Fx) 또는 <식> 옵션을 제공하는 모든 보고서 항목 속성 또는 입력란 속성에 사용할 수 있습니다. 식은 보고서의 내용과 모양을 다른 방법으로 제어하는 데도 사용됩니다. 자세한 내용은 식 예(보고서 작성기 2.0)를 참조하십시오.
런타임에 매개 변수 값을 데이터 집합 필드 값과 비교할 때는 비교하는 두 항목의 데이터 형식이 같아야 합니다. 보고서 매개 변수는 다음 유형 중 하나일 수 있습니다. Boolean, DateTime, Integer, Float 또는 Text(기본 데이터 형식인 String을 나타냄). 필요한 경우에는 데이터 집합 값과 일치하도록 매개 변수 값의 데이터 형식을 변환해야 할 수 있습니다. 자세한 내용은 식의 데이터 형식 작업(보고서 작성기 2.0)을 참조하십시오.
식에 매개 변수 참조를 포함하려면 매개 변수가 단일 값인지 다중값 매개 변수인지에 따라 달라지는 매개 변수 참조의 올바른 구문을 지정하는 방법을 이해해야 합니다.
식에서 단일 값 매개 변수 사용
다음 표에서는 식에서 임의 데이터 형식의 단일 값 매개 변수에 대한 참조를 포함할 때 사용할 구문의 예를 보여 줍니다.
예 |
설명 |
|---|---|
=Parameters!<ParameterName>.IsMultiValue |
False를 반환합니다. 매개 변수가 다중값인지 확인합니다. True일 경우 매개 변수는 다중값이며 개체 컬렉션입니다. False일 경우 매개 변수는 단일 값이며 단일 개체입니다. |
=Parameters!<ParameterName>.Count |
정수 값 1을 반환합니다. 단일 값 매개 변수의 경우 개수는 항상 1입니다. |
=Parameters!<ParameterName>.Label |
사용 가능한 값의 드롭다운 목록에서 표시 이름으로 자주 사용되는 매개 변수 레이블을 반환합니다. |
=Parameters!<ParameterName>.Value |
매개 변수 값을 반환합니다. Label 속성이 설정되지 않은 경우 이 값은 사용 가능한 값 드롭다운 목록에 표시됩니다. |
=CStr(Parameters! <ParameterName>.Value) |
매개 변수 값을 문자열로 반환합니다. |
=Fields(Parameters!<ParameterName>.Value).Value |
매개 변수와 동일한 이름을 갖고 있는 필드에 대해 값을 반환합니다. |
필터에 매개 변수를 사용하는 방법은 보고서의 보고서 데이터 필터링(보고서 작성기 2.0)을 참조하십시오.
식에서 다중값 매개 변수 사용
다음 표에서는 식에서 임의 데이터 형식의 다중값 매개 변수에 대한 참조를 포함할 때 사용할 구문의 예를 보여 줍니다.
예 |
설명 |
|---|---|
=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",",") |
값 배열을 반환합니다. 다중값 String 매개 변수에 대한 값 배열을 만듭니다. 분할할 두 번째 매개 변수에서 임의의 구분 기호를 사용할 수 있습니다. 다중값 매개 변수에 대한 기본값을 설정하거나, 포함된 보고서 또는 드릴스루 보고서에 전송할 다중값 매개 변수를 만드는 데 이 식을 사용할 수 있습니다. |
=Join(Parameters!<MultivalueParameterName>.Value,", ") |
다중값 매개 변수에서 쉼표로 구분된 값 목록으로 구성된 String을 반환합니다. 조인할 두 번째 매개 변수에서 임의의 구분 기호를 사용할 수 있습니다. |
필터에 매개 변수를 사용하는 방법은 보고서의 보고서 데이터 필터링(보고서 작성기 2.0)을 참조하십시오.