보고서 작성기 함수 - First 함수Report Builder Functions - First Function

지정된 식의 지정된 범위에서 첫 번째 값을 반환합니다.Returns the first value in the given scope of the specified expression.

참고

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.

구문Syntax


First(expression, scope)  

매개 변수Parameters

expressionexpression
(Variant 또는 Binary) 집계를 수행할 식의 예는 =Fields!FieldName.Value와 같습니다.(Variant or Binary) The expression on which to perform the aggregation, for example, =Fields!FieldName.Value.

범위scope
(문자열) 선택 사항입니다.(String) Optional. 집계 함수를 적용할 보고서 항목을 포함하는 데이터 집합, 그룹 또는 데이터 영역의 이름입니다.The name of a dataset, group, or data region that contains the report items to which to apply the aggregate function. scope 를 지정하지 않은 경우 현재 범위가 사용됩니다.If scope is not specified, the current scope is used.

반환 형식Return Type

식 유형에 따라 결정됩니다.Determined by the type of expression.

주의Remarks

First 함수는 지정된 범위에 모든 정렬 및 필터링을 적용한 후 데이터 집합에서 첫 번째 값을 반환합니다.The First function returns the first value in a set of data after all sorting and filtering have been applied at the specified scope.

First 함수는 그룹 필터 식에서 현재(기본) 범위 외에는 사용할 수 없습니다.The First function cannot be used in group filter expressions with anything except the current (default) scope.

페이지의 첫 번째와 마지막 항목을 표시하는 사전 스타일의 머리글을 만들기 위해 페이지 머리글에 First 를 사용하여 페이지에 대한 ReportItems 컬렉션의 첫 번째 값을 반환할 수도 있습니다.You can also use First in a page header to return the first value from the ReportItems collection for a page in order to produce dictionary-style headings that display the first and last entries on a page.

scope 의 값은 문자열 상수여야 하고 식일 수 없습니다.The value of scope must be a string constant andcannot be an expression. 외부 집계나 다른 집계를 지정하지 않는 집계의 경우 scope 는 현재 범위나 포함하는 범위를 참조해야 합니다.For outer aggregates or aggregates that do not specify other aggregates, scope must refer to the current scope or a containing scope. 집계의 집계의 경우 중첩 집계는 자식 범위를 지정할 수 있습니다.For aggregates of aggregates, nested aggregates can specify a child scope.

Expression 에는 다음 예외와 조건이 있는 중첩 집계 함수에 대한 호출이 포함될 수 있습니다.Expression can contain calls to nested aggregate functions with the following exceptions and conditions:

예제Example

다음 코드 예에서는 데이터 영역의 Category 그룹에서 첫 번째 제품 번호를 반환합니다.The following code example returns the first product number in the Category group of a data region:

=First(Fields!ProductNumber.Value, "Category")  

관련 항목:See Also

보고서에 사용되는 식(보고서 작성기 및 SSRS) Expression Uses in Reports (Report Builder and SSRS)
식 예(보고서 작성기 및 SSRS) Expression Examples (Report Builder and SSRS)
식의 데이터 형식(보고서 작성기 및 SSRS) Data Types in Expressions (Report Builder and SSRS)
합계, 집계 및 기본 제공 컬렉션의 식 범위(보고서 작성기 및 SSRS)Expression Scope for Totals, Aggregates, and Built-in Collections (Report Builder and SSRS)