Funktionerne First, FirstN, Index, Last og LastN

  • Artikel

Gælder for: Lærredsapps Skrivebordsflows Modeldrevne apps Power Platform CLI

Returnerer den første, sidste eller en bestemt post eller et sæt første eller sidste poster fra en tabel.

Beskrivelse

Funktionen First returnerer den første post i en tabel.

Funktionen FirstN returnerer det første sæt poster i en tabel. Det andet argument angiver, hvor mange poster der skal returneres.

Funktionen Last returnerer den sidste post i en tabel.

Funktionen LastN returnerer det sidste sæt poster i en tabel. Det andet argument angiver, hvor mange poster der skal returneres.

Funktionen Index returnerer en post i en tabel baseret på dens ordnede position i tabellen. Postnummerering starter med 1, så First( table ) returnerer den samme post som Index( table, 1 ). Index returnerer en fejl, hvis det ønskede postindeks er mindre end 1, større end antallet af poster i tabellen, eller hvis tabellen er tom.

First, Index og Last returnerer en enkelt post. FirstN og LastN returnerer en tabel. Også hvis du angiver, at der kun skal returneres én post.

Delegering

Disse funktioner kan ikke uddelegeres, når de bruges med en datakilde. Kun den første del af datakilden hentes, og derefter vil funktionen blive anvendt. Resultatet repræsenterer muligvis ikke hele historien. Der vises muligvis en advarsel på oprettelsestidspunktet for at minde dig om denne begrænsning og foreslå skift til alternativer, der kan uddelegeres, hvis det er muligt. Du kan finde flere oplysninger i uddelegeringsoversigten.

Når det f.eks. bruges sammen med en datakilde, der indeholder en stor tabel med 1 million poster, er Last underlagt den grænse, der ikke er delegering, og returnerer ikke den sidste post i hele datakilden. På samme måde vil brug af Index til at anmode om en post midt i 1 million poster resultere i en fejl, fordi indekset er uden for intervallet baseret på grænsen for ikke-delegering.

Syntaks

First( Table )
Last( Table )

  • Table – påkrævet. Tabel, der skal arbejdes med.

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

  • Table – påkrævet. Tabel, der skal arbejdes med.
  • NumberOfRecords – påkrævet. Antal poster, der skal returneres. Hvis du ikke angiver dette argument, returnerer funktionen én post.

Index( Table, RecordIndex )

  • Table – påkrævet. Tabel, der skal arbejdes med.
  • RecordIndex – påkrævet. Indekset for den post, der skal returneres. Postnummerering begynder med 1.

Eksempler

I følgende eksempler bruger vi IceCream-datakilden, som indeholder dataene i denne tabel:

Eksempel på IceCream.

Denne tabel kan placeres i en samling med denne formel (læg den i formlen OnStart for et knapkontrolelement, og tryk på knappen):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )
Formel Beskrivelse Resultat
First( IceCream ) Returnerer den første post i IceCream. { Flavor: "Chocolate", Quantity: 100 }
Last( IceCream ) Returnerer den sidste post i IceCream. { Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 ) Returnerer den tredje post i IceCream. { Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 ) Returnerer en tabel, der indeholder de første to poster i IceCream. Tabel, der indeholder poster for Chocolate og Vanilla
LastN( IceCream, 2 ) Returnerer en tabel, der indeholder de sidste to poster i IceCream. Tabel, der indeholder poster for Mint Chocolate og Pistachio
Index( IceCream, 4 ).Quantity Returnerer den fjerde post i tabellen og udtrækker kolonnen Quanity. 60
Index( IceCream, 10 ) Returnerer en fejl, da den post, der anmodes om, er uden for tabellens grænser. Fejl