Функция First (построитель отчетов и службы SSRS)
Возвращает первое значение указанного выражения для заданной области.
Примечание
Создавать и изменять определения отчетов (RDL-файлы) в SQL Server Data Tools можно в построителе отчетов и конструкторе отчетов В каждой среде разработки существуют различные способы создания, открытия и сохранения отчетов и связанных элементов. Дополнительные сведения см. в статье Проектирование отчетов в конструктор отчетов и Report Builder (SSRS) в Интернете на microsoft.com.
Синтаксис
First(expression, scope)
Параметры
expression
(Variant
или Binary
) Выражение, к которому применяется статистическая обработка, например =Fields!FieldName.Value
.
область
(String
) Необязательно. Имя набора данных, группы или области данных, содержащих элементы отчета, к которым применяется агрегатная функция. Если аргумент scope не задан, используется текущая область.
Тип возвращаемых данных
Определяется типом выражения.
Remarks
Функция First
возвращает первое значение в наборе данных после того, как для указанной области были применены сортировка и фильтрация.
Функция First
не может использоваться в критериях фильтра группирования с какой-либо областью, кроме текущей области (по умолчанию).
Функцию First
можно также использовать в заголовке странице, чтобы вернуть первое значение набора ReportItems
для страницы, с целью создания словарных заголовков, в которых отображаются первая и последняя записи страницы.
Значение scope должно быть строковой константой и не может быть выражением. Для внешних агрегатов и агрегатов, в которых не задаются другие агрегаты, параметр scope должен ссылаться не текущую область или включающую область. Для агрегатов, содержащих агрегаты, во вложенных агрегатах может указываться дочерняя область.
Expression может содержать вызовы вложенных агрегатных функций со следующими условиями и исключениями.
ПараметрScope для вложенных агрегатов должен совпадать с областью внешнего агрегата или входить в нее. Одна область из всех уникальных областей в выражении должна быть дочерней относительно всех других областей.
ПараметрScope для вложенных агрегатов не может быть именем набора данных.
Выражение не должно содержать
First
функции ,Last
,Previous
, илиRunningValue
.Expression не может содержать вложенные агрегаты, в которых указан параметр recursive.
Дополнительные сведения см. в статьях Функции построителя отчетов — справочник по агрегатным функциям в отчетах с разбивкой на страницы (построитель отчетов) и Область выражения для суммирования, статистических выражений и встроенных коллекций в отчете с разбивкой на страницы (построитель отчетов).
Дополнительные сведения о рекурсивных агрегатах см. в разделе Создание групп рекурсивной иерархии (построитель отчетов и службы SSRS).
Пример
Следующий пример кода возвращает первый номер продукта в группировании или области данных Category
:
=First(Fields!ProductNumber.Value, "Category")
См. также:
Использование выражений в отчетах (построитель отчетов и службы SSRS)
Примеры выражений (построитель отчетов и службы SSRS)
Типы данных в выражениях (построитель отчетов и службы SSRS)
Область выражения для итогов, агрегатных функций и встроенных коллекций (построитель отчетов и службы SSRS)