De functies First, FirstN, Index, Last en LastN

Van toepassing op: Canvas-apps Bureaubladstromen Modelgestuurde apps 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 aangevraagde recordindex kleiner is dan 1 of groter is dan het aantal records in de tabel, of als de tabel leeg is.

First, Index en Last retourneren een enkele 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

First( Table )
Last( Table )

• Table: vereist. De tabel waarop de bewerking wordt toegepast.

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

• Table: vereist. 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 )

• Table: vereist. 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
First( IceCream )	Retourneert de eerste record van IceCream.	{ Flavor: "Chocolate", Quantity: 100 }
Last( IceCream )	Retourneert de laatste record van IceCream.	{ Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 )	Retourneert de derde record van IceCream.	{ Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 )	Retourneert een tabel met de eerste twee records van IceCream.
LastN( IceCream, 2 )	Retourneert een tabel met de laatste twee records van IceCream.
Index( IceCream, 4 ).Quantity	Retourneert de vierde record van de tabel en extraheert de kolom Quantity.	60
Index( IceCream, 10 )	Retourneert een fout omdat de aangevraagde record buiten de grenzen van de tabel valt.	Fout