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

  • Статья

Применимо к: приложениям на основе холста классическим потокам приложениям на основе модели интерфейсу командной строки Power Platform

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

Описание

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

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

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

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

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

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

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

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

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

Синтаксис

First( Table )
Last( Table )

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

FirstN( Table [, NumberOfRecords ] )
LastN( Table [, NumberOfRecords ] )

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

Index( Table, RecordIndex )

  • таблица — обязательный аргумент. Таблица, с которой выполняются операции.
  • 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 } ) )
Формула Описание Результат
First( IceCream ) Возвращает первую запись IceCream. { Flavor: "Chocolate", Quantity: 100 }
Last( IceCream ) Возвращает последнюю запись IceCream. { Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 ) Возвращает третью запись IceCream. { Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 ) Возвращает таблицу, содержащую первые две записи IceCream. Таблица, содержащая записи для шоколада и ванили
LastN( IceCream, 2 ) Возвращает таблицу, содержащую последние две записи IceCream. Таблица, содержащая записи для шоколада с мятой и фисташек
Index( IceCream, 4 ).Quantity Возвращает четвертую запись таблицы и извлекает столбец Quantity. 60
Index( IceCream, 10 ) Возвращает ошибку, так как запрошенная запись выходит за пределы таблицы. Ошибка