Поделиться через

Функции First, FirstN, Index, Last и LastN

  • Статья

Применимо к: Приложениям Canvas Потокам рабочего стола Приложениям на основе моделей Power Pages Power Platform CLI

Возвращает первую, последнюю или конкретную запись или набор первых или последних записей из таблицы.

Описание

Функция First возвращает первую запись таблицы.

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

Функция Last возвращает последнюю запись таблицы.

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

Показатель Index возвращает запись таблицы на основе ее упорядоченной позиции в таблице. Нумерация записей начинается с 1, поэтому First( table ) возвращает ту же запись, что и Index( table, 1 ). Index возвращает ошибку, если запрошенный индекс записи меньше 1, больше количества записей в таблице или таблица пуста.

First, Index и Last возвращают одну запись. FirstN и LastN возвращают таблицу, даже если указана только одна запись.

Делегирование

При использовании с источником данных эти функции невозможно делегировать. Будет извлечена только первая часть источника данных, затем будет применена функция. Результат может не отражать ситуацию в целом. Во время разработки может отобразиться предупреждение, чтобы напомнить об этом ограничении и предложить по возможности переключиться на подлежащие делегированию альтернативы. Дополнительные сведения см. в обзоре делегирования.

Например, при использовании с источником данных, содержащим большую таблицу с 1 миллионом записей, для Last будет применяться ограничение на неделегирование и не будет возвращаться последняя запись всего источника данных. Точно так же, использование Index, чтобы запросить запись в середине 1 миллиона записей, приведет к ошибке, поскольку индекс выходит за пределы допустимого предела неделегирования.

Синтаксис

Первая( Таблица )
Последняя( Таблица )

  • Таблица - Обязательно. Таблица, с которой выполняются операции.

FirstN( Таблица [, КоличествоЗаписей ] )
LastN( Таблица [, КоличествоЗаписей ] )

  • Таблица - Обязательно. Таблица, с которой выполняются операции.
  • NumberOfRecords - Необязательно. Количество возвращаемых записей. Если не указать этот аргумент, то функция возвратит одну запись.

Индекс( Таблица, ИндексЗаписи )

  • Таблица - Обязательно. Таблица, с которой выполняются операции.
  • RecordIndex - Обязательно. Индекс записи, которую требуется вернуть. Нумерация записей начинается с 1.

Примеры

В следующих примерах мы будем использовать источник данных IceCream, который содержит данные в виде такой таблицы:

Пример мороженого.

Эта таблица может быть помещена в коллекцию с помощью этой формулы (вставьте формулу OnStart для элемента управления Button и нажмите кнопку):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )
Формула Описание Результат
Первое(Мороженое) Возвращает первую запись IceCream. { Flavor: "Chocolate", Quantity: 100 }
Последний( Мороженое) Возвращает последнюю запись IceCream. { Flavor: "Pistachio", Quantity: 200 }
Индекс( Мороженое, 3 ) Возвращает третью запись IceCream. { Flavor: "Strawberry", Quantity: 300 }
FirstN(Мороженое, 2) Возвращает таблицу, содержащую первые две записи IceCream. Таблица, содержащая записи для шоколада и ванили
LastN(Мороженое, 2) Возвращает таблицу, содержащую последние две записи IceCream. Таблица, содержащая записи для шоколада с мятой и фисташек
Индекс(Мороженое, 4).Количество Возвращает четвертую запись таблицы и извлекает столбец Quantity. 60
Индекс(Мороженое, 10) Возвращает ошибку, так как запрошенная запись выходит за пределы таблицы. Ошибка