De functies First, FirstN, Index, Last en LastN

Van toepassing op: Canvas-apps Bureaublad-stromen Modelgestuurde apps Power Pages Power Platform CLI

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

Beschrijving

De functie First retourneert de eerste record van een tabel.

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

De functie Last retourneert de laatste record van een tabel.

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

De functie 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 opgevraagde recordindex kleiner is dan 1, groter is dan het aantal records in de tabel of als de tabel leeg is.

Eerste, Index en Laatste retourneert één record. FirstN en LastN retourneren 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.

Als het bijvoorbeeld wordt gebruikt met een gegevensbron die een grote tabel met 1 miljoen records bevat, is Last onderworpen aan de niet-overdrachtslimiet en wordt niet de laatste record van de hele gegevensbron geretourneerd. Evenzo resulteert het gebruik van Index voor het aanvragen van een record in het midden van 1 miljoen records in een fout omdat de index buiten het bereik valt op basis van de niet-overdrachtslimiet.

Syntaxis

Eerste( Tabel )
Laatste( Tabel )

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

EersteN( Tabel [, AantalRecords ] )
LaatsteN( Tabel [, AantalRecords ] )

• 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( Tabel, 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 IceCream-gegevensbron, 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
Eerste (ijs)	Retourneert de eerste record van IceCream.	{ Flavor: "Chocolate", Quantity: 100 }
Laatste (ijsje)	Retourneert de laatste record van IceCream.	{ Flavor: "Pistachio", Quantity: 200 }
Index( IJs, 3 )	Retourneert de derde record van IceCream.	{ Flavor: "Strawberry", Quantity: 300 }
EersteN( IJs, 2 )	Retourneert een tabel met de eerste twee records van IceCream.
LaatsteN( 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