First, , FirstNIndex, , Lasten LastN functies

Van toepassing op: Canvas-apps Copilot Studio Desktop stromen Modelgestuurde apps Power Platform CLI Dataverse-functies Power Pages

Retourneert de eerste, laatste of een specifieke record, of een set eerste of laatste records, uit een tabel.

Beschrijving

De First functie retourneert de eerste record van een tabel.

De FirstN functie retourneert de eerste set records van een tabel. Het tweede argument geeft het aantal records op dat moet worden geretourneerd.

De Last functie retourneert de laatste record van een tabel.

De LastN functie retourneert de laatste set records van een tabel. Het tweede argument geeft het aantal records op dat moet worden geretourneerd.

De Index functie retourneert een record van een tabel op basis van de geordende positie in de tabel. Recordnummering begint met 1 dus retourneert First( table ) dezelfde record als Index( table, 1 ). Index retourneert een fout als de aangevraagde recordindex kleiner is dan 1, groter is dan het aantal records in de tabel of de tabel leeg is.

First, Indexen Last retourneer één record. FirstN en LastN retourneert een tabel, zelfs als u slechts één record opgeeft.

Delegering

Als deze functies worden gebruikt met een gegevensbron, kunnen ze niet worden overgedragen. Alleen het eerste deel van de gegevensbron wordt opgehaald en vervolgens wordt de functie toegepast. Het resultaat is mogelijk niet volledig. Tijdens het schrijven ziet u mogelijk een waarschuwing om u te herinneren aan deze beperking en om u erop te wijzen dat u waar mogelijk kunt overschakelen naar alternatieven met overdrachtmogelijkheden. Zie het overdrachtoverzicht voor meer informatie.

Wanneer u bijvoorbeeld wordt gebruikt met een gegevensbron met een grote tabel met 1 miljoen records, Last is deze onderworpen aan de limiet voor niet-delegering en wordt de laatste record van de hele gegevensbron niet geretourneerd. Het gebruik om Index een record in het midden van 1 miljoen records aan te vragen, resulteert eveneens in een fout omdat de index buiten het bereik valt op basis van de limiet voor niet-delegering.

Syntaxis

First( Tabel )
Last( Tabel )

• Tabel - Verplicht. De tabel waarop de bewerking wordt toegepast.

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

• Tabel - Verplicht. De tabel waarop de bewerking wordt toegepast.
• NumberOfRecords - Optioneel. Het aantal te retourneren records. Als u dit argument niet opgeeft, retourneert de functie één record.

Index( Table, RecordIndex )

• Tabel - Verplicht. De tabel waarop de bewerking wordt toegepast.
• RecordIndex - Vereist. De index van de record die moet worden geretourneerd. Recordnummering begint met 1.

Voorbeelden

Voor de volgende voorbeelden gebruiken we de IJsgegevensbron, die de gegevens in deze tabel bevat:

Deze tabel kan met deze formule in een verzameling worden geplaatst (vul de OnStart-formule in voor een besturingselement Button en druk op de knop):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )

Formule	Beschrijving	Resultaat
First( IJs )	Retourneert de eerste record van IceCream.	{ Smaak: "Chocolade", Hoeveelheid: 100 }
Last( IJs )	Retourneert de laatste record van IceCream.	{ Smaak: "Pistache", Hoeveelheid: 200 }
Index( IJs, 3 )	Retourneert de derde record van IceCream.	{ Smaak: "Aardbeien", Hoeveelheid: 300 }
FirstN( IJs, 2 )	Retourneert een tabel met de eerste twee records van IceCream.
LastN( IJs, 2 )	Retourneert een tabel met de laatste twee records van IceCream.
Index( IJs, 4 ). Hoeveelheid	Retourneert de vierde record van de tabel en extraheert de kolom Quantity.	60
Index( IJs, 10 )	Retourneert een fout omdat de aangevraagde record buiten de grenzen van de tabel valt.	Fout