Функция First (построитель отчетов версии 3.0 и службы SSRS)

Возвращает первое значение указанного выражения для заданной области.

ПримечаниеПримечание

В построителе отчетов и в конструкторе отчетов среды Business Intelligence Development Studio можно создавать и изменять определения отчета (RDL). В каждой среде разработки существуют различные способы создания, открытия и сохранения отчетов и связанных элементов. Дополнительные сведения см. в разделе Разработка отчетов в построителе отчетов и конструкторе отчетов 3.0 (SSRS) на веб-сайте microsoft.com.

Синтаксис

First(expression, scope)

Параметры

  • expression
    (Variant или Binary) Выражение, к которому применяется статистическая обработка, например =Fields!FieldName.Value.

  • scope
    (String) Необязательный. Имя набора данных, группы или области данных, содержащих элементы отчета, к которым применяется агрегатная функция. Если аргумент scope не задан, используется текущая область.

Тип возвращаемых данных

Определяется типом выражения.

Замечания

Функция First возвращает первое значение в наборе данных после того, как для указанной области были применены сортировка и фильтрация.

Функция First не может использоваться в критериях фильтра группирования с какой-либо областью, кроме текущей области (по умолчанию).

Функцию First можно также использовать в заголовке странице, чтобы вернуть первое значение набора ReportItems для страницы, с целью создания словарных заголовков, в которых отображаются первая и последняя записи страницы.

Значение scope должно быть строковой константой ине может являться выражением. Для внешних агрегатов и агрегатов, в которых не задаются другие агрегаты, параметр scope должен ссылаться не текущую область или включающую область. Для агрегатов, содержащих агрегаты, во вложенных агрегатах может указываться дочерняя область.

Expression может содержать вызовы вложенных агрегатных функций со следующими условиями и исключениями.

  • Параметр Scope для вложенных агрегатов должен совпадать с областью внешнего агрегата или входить в нее. Одна область из всех уникальных областей в выражении должна быть дочерней относительно всех других областей.

  • Параметр Scope для вложенных агрегатов не может быть именем набора данных.

  • Expression не может содержать функции First, Last, Previous и RunningValue.

  • Expression не может содержать вложенные агрегаты, в которых указан параметр recursive.

Дополнительные сведения см. в разделах Справочник по агрегатным функциям (построитель отчетов версии 3.0 и службы SSRS) и Общие сведения об области выражений для суммирования, агрегатных функций и встроенных коллекций (построитель отчетов версии 3.0 и службы SSRS).

Дополнительные сведения о рекурсивных агрегатах см. в разделе Создание групп рекурсивной иерархии (построитель отчетов версии 3.0 и службы SSRS).

Пример

Следующий пример кода возвращает первый номер продукта в группировании или области данных Category:

=First(Fields!ProductNumber.Value, "Category")
  • Last updated on