기본 제공 컬렉션-매개 변수 컬렉션 참조 (보고서 작성기)Built-in Collections - Parameters Collection References (Report Builder)

보고서 매개 변수는 식에서 참조할 수 있는 기본 제공 컬렉션 중 하나입니다.Report parameters are one of the built-in collections you can reference from an expression. 식에 매개 변수를 포함하면 사용자의 선택에 따라 보고서 데이터와 모양을 사용자 지정할 수 있습니다.By including parameters in an expression, you can customize report data and appearance based on choices a user makes. 모든 보고서 항목 속성 또는 제공 하는 텍스트 상자 속성에 대 한 식을 사용할 수 있습니다는 (Fx) 또는 < > 옵션입니다.Expressions can be used for any report item property or text box property that provides the (Fx) or <Expression> option. 식은 보고서의 내용과 모양을 다른 방법으로 제어하는 데도 사용됩니다.Expressions are also used to control report content and appearance in other ways. 자세한 내용은 식 예(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Expression Examples (Report Builder and SSRS).

런타임에 매개 변수 값을 데이터 집합 필드 값과 비교할 때는 비교하는 두 항목의 데이터 형식이 같아야 합니다.When you compare parameter values with dataset field values at run time, the data types for the two items you are comparing must be the same. 보고서 매개 변수는 다음 유형 중 하나일 수 있습니다. Boolean, DateTime, Integer, Float 또는 Text(기본 데이터 형식인 String을 나타냄).Report parameters can be one of the following types: Boolean, DateTime, Integer, Float, or Text, which represents the underlying data type String. 필요한 경우에는 데이터 집합 값과 일치하도록 매개 변수 값의 데이터 형식을 변환해야 할 수 있습니다.If necessary, you might have to convert the data type of the parameter value to match the dataset value. 자세한 내용은 식의 데이터 형식(보고서 작성기 및 SSRS)).For more information, see Data Types in Expressions (Report Builder and SSRS).

식에 매개 변수 참조를 포함하려면 매개 변수가 단일 값인지 다중값 매개 변수인지에 따라 달라지는 매개 변수 참조의 올바른 구문을 지정하는 방법을 이해해야 합니다.In order to include a parameter reference in an expression, you must understand how to specify the correct syntax for the parameter reference, which varies depending on whether the parameter is a single-value or multivalue parameter.

참고

SQL Server Data Tools의 보고서 작성기 및 보고서 디자이너에서 페이지를 매긴 보고서 정의(.rdl) 파일을 만들고 수정할 수 있습니다.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다.Each authoring environment provides different ways to create, open, and save reports and related items.

식에서 단일 값 매개 변수 사용 Using a Single-Valued Parameter in an Expression

다음 표에서는 식에서 임의 데이터 형식의 단일 값 매개 변수에 대한 참조를 포함할 때 사용할 구문의 예를 보여 줍니다.The following table shows examples of the syntax to use when you include a reference to a single-value parameter of any data type in an expression.

예제Example DescriptionDescription
=Parameters! <ParameterName >.IsMultiValue=Parameters! <ParameterName> .IsMultiValue False를 반환합니다.Returns False.

매개 변수가 다중값인지 확인합니다.Checks if a parameter is multivalue. True일 경우 매개 변수는 다중값이며 개체 컬렉션입니다.If True, the parameter is multivalue and it is a collection of objects. False일 경우 매개 변수는 단일 값이며 단일 개체입니다.If False, the parameter is single-value and is a single object.
=Parameters! <ParameterName >.Count=Parameters! <ParameterName> .Count 정수 값 1을 반환합니다.Returns the integer value 1. 단일 값 매개 변수의 경우 개수는 항상 1입니다.For a single-value parameter, the count is always 1.
=Parameters! <ParameterName >.Label=Parameters! <ParameterName> .Label 사용 가능한 값의 드롭다운 목록에서 표시 이름으로 자주 사용되는 매개 변수 레이블을 반환합니다.Returns the parameter label, frequently used as the display name in a drop-down list of available values.
=Parameters! <ParameterName >.Value=Parameters! <ParameterName> .Value 매개 변수 값을 반환합니다.Returns the parameter value. Label 속성이 설정되지 않은 경우 이 값은 사용 가능한 값 드롭다운 목록에 표시됩니다.If the Label property has not been set, this value appears in the drop-down list of available values.
=CStr(Parameters! <ParameterName >.Value)=CStr(Parameters! <ParameterName> .Value) 매개 변수 값을 문자열로 반환합니다.Returns the parameter value as a string.
=Fields(Parameters! <ParameterName >.Value).Value=Fields(Parameters! <ParameterName> .Value).Value 매개 변수와 동일한 이름을 갖고 있는 필드에 대해 값을 반환합니다.Returns the value for the field that has the same name as the parameter.

필터에서 매개 변수를 사용하는 방법은 데이터 집합 필터, 데이터 영역 필터 및 그룹 필터 추가(보고서 작성기 및 SSRS)를 참조하세요.For more information about using parameters in a filter, see Add Dataset Filters, Data Region Filters, and Group Filters (Report Builder and SSRS).

식에서 다중값 매개 변수 사용 Using a Multivalue Parameter in an Expression

다음 표에서는 식에서 임의 데이터 형식의 다중값 매개 변수에 대한 참조를 포함할 때 사용할 구문의 예를 보여 줍니다.The following table shows examples of the syntax to use when you include a reference to a multivalue parameter of any data type in an expression.

예제Example DescriptionDescription
=Parameters! <MultivalueParameterName >.IsMultiValue=Parameters! <MultivalueParameterName> .IsMultiValue True 또는 False를 반환합니다.Returns True or False.

매개 변수가 다중값인지 확인합니다.Checks if a parameter is multivalue. True일 경우 매개 변수는 다중값이며 개체 컬렉션입니다.If True, the parameter is multivalue and is a collection of objects. False일 경우 매개 변수는 단일 값이며 단일 개체입니다.If False, the parameter is single-valued and is a single object.
=Parameters! <MultivalueParameterName >.Count=Parameters! <MultivalueParameterName> .Count 정수 값을 반환합니다.Returns an integer value.

값 개수를 나타냅니다.Refers to the number of values. 단일 값 매개 변수의 경우 개수는 항상 1입니다.For a single-value parameter, the count is always 1. 다중값 매개 변수의 경우 개수는 0개 이상입니다.For a multivalue parameter, the count is 0 or more.
=Parameters! <MultivalueParameterName >.Value(0)=Parameters! <MultivalueParameterName> .Value(0) 다중값 매개 변수의 첫 번째 값을 반환합니다.Returns the first value in a multivalue parameter.
=Parameters! <MultivalueParameterName > .Value(Parameters! <MultivalueParameterName >.Count-1)=Parameters! <MultivalueParameterName> .Value(Parameters! <MultivalueParameterName> .Count-1) 다중값 매개 변수의 마지막 값을 반환합니다.Returns the last value in a multivalue parameter.
=Split("Value1,Value2,Value3",",") 값 배열을 반환합니다.Returns an array of values.

다중값 String 매개 변수에 대한 값 배열을 만듭니다.Create an array of values for a multivalue String parameter. 분할할 두 번째 매개 변수에서 임의의 구분 기호를 사용할 수 있습니다.You can use any delimiter in the second parameter to Split. 다중값 매개 변수에 대한 기본값을 설정하거나, 하위 보고서 또는 드릴스루 보고서에 전송할 다중값 매개 변수를 만드는 데 이 식을 사용할 수 있습니다.This expression can be used to set defaults for a multivalue parameter or to create a multivalue parameter to send to a subreport or drillthrough report.
=Join(Parameters! <MultivalueParameterName >.Value,", ")=Join(Parameters! <MultivalueParameterName> .Value,", ") 다중값 매개 변수에서 쉼표로 구분된 값 목록으로 구성된 String 을 반환합니다.Returns a String that consists of a comma-delimited list of values in a multivalue parameter. 조인할 두 번째 매개 변수에서 임의의 구분 기호를 사용할 수 있습니다.You can use any delimiter in the second parameter to Join.

필터에서 매개 변수를 사용 하는 방법에 대 한 자세한 내용은 참조 보고서 매개 변수 사용 ( 보고서 작성기 및 보고서 디자이너 ) .For more information about using parameters in a filter, see Report Parameters (Report Builder and Report Designer).

관련 항목:See Also

식(보고서 작성기 및 SSRS) Expressions (Report Builder and SSRS)
일반적으로 사용 되는 필터 ( 보고서 작성기 및 SSRS ) Commonly Used Filters (Report Builder and SSRS)
추가, 변경 또는 보고서 매개 변수 ( 삭제 보고서 작성기 및 SSRS ) Add, Change, or Delete a Report Parameter (Report Builder and SSRS)
자습서: 보고서 ( 매개 변수 추가 보고서 작성기 ) Tutorial: Add a Parameter to Your Report (Report Builder)
보고서 작성기 자습서 Report Builder Tutorials
식 (의 기본 제공 컬렉션 보고서 작성기 및 SSRS )Built-in Collections in Expressions (Report Builder and SSRS)