Funkcje First, FirstN, Index, Last i LastN
Dotyczy: Aplikacje kanwy Przepływy pulpitu Aplikacje oparte na modelu Power Pages Power Platform CLI
Zwraca pierwszy, ostatni lub określony rekord albo zestaw pierwszych lub ostatnich rekordów z tabeli.
Opis
Funkcja First zwraca pierwszy rekord tabeli.
Funkcja FirstN zwraca pierwszy zestaw rekordów tabeli; drugi argument określa liczbę rekordów do zwrócenia.
Funkcja Last zwraca ostatni rekord tabeli.
Funkcja LastN zwraca ostatni zestaw rekordów tabeli; drugi argument określa liczbę rekordów do zwrócenia.
Funkcja Index zwraca rekord tabeli na podstawie uporządkowanej pozycji tabeli. Numerowanie rekordu zaczyna się od 1, First( table )
więc zwracany jest ten sam rekord, co Index( table, 1 )
.
Index zwraca błąd, jeśli żądany indeks rekordu jest mniejszy niż 1, większa niż liczba rekordów w tabeli lub tabela jest pusta.
Funkcje First, Index i Last zwracają jeden rekord. Funkcje FirstN i LastN zwracają tabelę, nawet jeśli zostanie określony tylko jeden rekord.
Delegowanie
Tych funkcji nie można delegować, gdy są używane ze źródłem danych. Zostanie pobrana tylko pierwsza część źródła danych, a następnie zostanie zastosowana funkcja. Wynik może nie odpowiadać pełnym informacjom. W czasie tworzenia może zostać wyświetlone ostrzeżenie przypominające o tym ograniczeniu i sugerujące użycie delegowalnych alternatyw, jeśli jest to możliwe. Aby uzyskać więcej informacji, zobacz Omówienie delegowania.
Na przykład w przypadku użycia ze źródłem danych zawierającym dużą tabelę z 1 milionem rekordów Last będzie podlegać ograniczeniu braku delegowania i nie zwróci ostatniego rekordu z całego źródła danych. Podobnie użycie Index do żądania rekordu w środku 1 miliona rekordów spowoduje błąd, ponieważ indeks jest poza zakresem w oparciu o limit braku delegowania.
Składnia
First( Tabela )
Last( Tabela )
- Tabela – wymagane. Tabela, na której będą wykonywane działania.
FirstN( Tabela [, LiczbaRekordów ] )
LastN( Tabela [, LiczbaRekordów ] )
- Tabela – wymagane. Tabela, na której będą wykonywane działania.
- NumberOfRecords – opcjonalne. Liczba rekordów do zwrócenia. Jeśli ten argument nie jest określony, funkcja zwraca jeden rekord.
Index( Table, RecordIndex )
- Tabela – wymagane. Tabela, na której będą wykonywane działania.
- RecordIndex — wymagane. Indeks rekordu do zwrócenia. Numerowanie rekordu zaczyna się od 1.
Przykłady
W poniższych przykładach użyto źródła danych IceCream, które zawiera dane z tej tabeli:
Ta tabela może być umieszczona w kolekcji za pomocą tej formuły (wstaw formułę OnStart dla kontrolki Button i naciśnij przycisk):
Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
{ Flavor: "Vanilla", Quantity: 200 },
{ Flavor: "Strawberry", Quantity: 300 },
{ Flavor: "Mint Chocolate", Quantity: 60 },
{ Flavor: "Pistachio", Quantity: 200 } ) )
Formuła | Opis | Result |
---|---|---|
First( IceCream ) | Zwraca pierwszy rekord z IceCream. | { Flavor: "Chocolate", Quantity: 100 } |
Last( IceCream ) | Zwraca ostatni rekord z IceCream. | { Flavor: "Pistachio", Quantity: 200 } |
Index( IceCream, 3 ) | Zwraca trzeci rekord z IceCream. | { Flavor: "Strawberry", Quantity: 300 } |
FirstN( IceCream, 2 ) | Zwraca tabelę zawierającą dwa pierwsze rekordy IceCream. | |
LastN( IceCream, 2 ) | Zwraca tabelę zawierającą dwa ostatnie rekordy IceCream. | |
Index( IceCream, 4 ).Quantity | Zwraca czwarty rekord tabeli i wyodrębnia kolumnę Ilość. | 60 |
Index( IceCream, 10 ) | Zwraca błąd, ponieważ żądany rekord jest wykraczający poza granice tabeli. | Błąd |