Delen via


Report Builder-functies - Eerste functie in een gepagineerd rapport (Report Builder)

Van toepassing op: Microsoft Report Builder (SSRS) Power BI Report Builder Report Designer in SQL Server Data Tools

Retourneert de eerste waarde in het opgegeven bereik van de opgegeven expressie in een gepagineerd rapport.

Opmerking

U kunt gepagineerde rapportdefinitiebestanden (.rdl) maken en wijzigen in Microsoft Report Builder, Power BI Report Builder en in Report Designer in SQL Server Data Tools.

Syntaxis

  
First(expression, scope)  

Parameterwaarden

expressie
(Variant of binair) De expressie waarop de aggregatie moet worden uitgevoerd, =Fields!FieldName.Valuebijvoorbeeld.

scope
(Tekenreeks) Optioneel. De naam van een gegevensset, groep of gegevensgebied met de rapportitems waarop de statistische functie moet worden toegepast. Als het bereik niet is opgegeven, wordt het huidige bereik gebruikt.

Retourtype

Bepaald door het type expressie.

Opmerkingen

De functie First retourneert de eerste waarde in een set gegevens nadat alle sortering en filtering zijn toegepast op het opgegeven bereik.

De functie First kan niet worden gebruikt in groepsfilterexpressies met uitzondering van het huidige (standaard) bereik.

U kunt ook First in een paginaheader gebruiken om de eerste waarde van de verzameling ReportItems voor een pagina te retourneren om koppen in woordenlijststijl te maken waarin de eerste en laatste vermeldingen op een pagina worden weergegeven.

De waarde van het bereik moet een tekenreeksconstante zijn en mag geen expressie zijn. Voor externe aggregaten of aggregaten die geen andere aggregaten specificeren, moet het bereik verwijzen naar het huidige bereik of een omvattend bereik. Voor aggregaties van aggregaties kunnen geneste aggregaties een kindbereik opgeven.

Expressie kan aanroepen van geneste aggregatiefuncties bevatten met de volgende uitzonderingen en voorwaarden:

  • Bereik voor geneste aggregaten moet hetzelfde zijn als, of opgenomen worden in, het bereik van de buitenste aggregaat. Voor alle afzonderlijke domeinen in de expressie moet één domein een ondergeschikte relatie hebben met alle andere domeinen.

  • Het bereik voor geneste aggregaties kan niet de naam van een gegevensset zijn.

  • De expressie mag geen functies First, Last, Previous of RunningValue bevatten.

  • Expressie mag geen geneste aggregaties bevatten die recursief aangeven.

Zie Aggregate Functions Reference (Report Builder en SSRS) enexpressiebereik voor totalen, aggregaties en ingebouwde verzamelingen (Report Builder en SSRS) voor meer informatie.

Zie Recursieve hiërarchiegroepen maken (Report Builder en SSRS) voor meer informatie over recursieve aggregaties.

Example

In het volgende codevoorbeeld wordt het eerste productnummer in de Category groep van een gegevensregio geretourneerd:

=First(Fields!ProductNumber.Value, "Category")