Report Builder-Funktionen – First-Funktion in einem paginierten Bericht (Report Builder)

Gilt für: Microsoft Report Builder (SSRS) Power BI Report Builder Berichts-Designer in SQL Server Data Tools

Gibt den ersten Wert des angegebenen Ausdrucks im angegebenen Bereich in einem paginierten Bericht zurück.

Hinweis

Sie können paginierte Berichtsdefinitionsdateien (.rdl) im Berichts-Generator von Microsoft, im Power BI Report Builder und im Berichts-Designer in SQL Server-Datentools erstellen und ändern.

Syntax

  
First(expression, scope)

Parameter

expression
(Variant oder Binär) Der Ausdruck, für den die Aggregation auszuführen ist. Beispiel: =Fields!FieldName.Value.

scope
(Zeichenfolge) Optional. Der Name eines Datasets, einer Gruppe oder eines Datenbereichs mit den Berichtselementen, auf die die Aggregatfunktion anzuwenden ist. Wenn scope nicht angegeben ist, wird der aktuelle Bereich verwendet.

Rückgabetyp

Wird durch den Typ des Ausdrucks bestimmt.

Bemerkungen

Die First -Funktion gibt den ersten Wert in einem Satz von Daten zurück, nachdem alle Sortierfunktionen und Filter im angegebenen Bereich angewendet wurden.

Die First-Funktion kann in Gruppenfilterausdrücken nur mit dem aktuellen (Standard-)Gültigkeitsbereich verwendet werden.

Sie können die First -Funktion auch in einem Seitenkopf verwenden, um den ersten Wert der ReportItems -Auflistung für eine Seite zurückzugeben und Überschriften im Wörterbuchformat zu erstellen, die den ersten und den letzten Eintrag auf einer Seite anzeigen.

Der Wert des scope -Objekts muss eine Zeichenfolgenkonstante sein und darf kein Ausdruck sein. Für äußere Aggregate oder Aggregate, die keine anderen Aggregate angeben, muss das scope -Objekt auf den aktuellen Bereich oder einen enthaltenen Bereich verweisen. Für Aggregate von Aggregaten können geschachtelte Aggregate einen untergeordneten Gültigkeitsbereich angeben.

DasExpression -Objekt kann Aufrufe von geschachtelten Aggregatfunktionen enthalten. Dabei gelten folgende Ausnahmen und Bedingungen:

  • Der Geltungsbereich für geschachtelte Aggregate muss mit dem Geltungsbereich des äußeren Aggregats übereinstimmen oder in ihm enthalten sein. Für alle verschiedenen Bereiche im Ausdruck muss ein Bereich allen anderen Bereichen untergeordnet sein.

  • Scope für geschachtelte Aggregate darf nicht der Name eines Datensatzes sein.

  • DasExpression -Objekt darf die Funktionen First, Last, Previousoder RunningValue nicht enthalten.

  • Der Ausdruck darf keine geschachtelten Aggregate enthalten, die recursive angeben.

Weitere Informationen finden Sie in der Aggregatfunktionsreferenz (Berichts-Generator und SSRS) und unter Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS).

Weitere Informationen zu rekursiven Aggregaten finden Sie unter Erstellen rekursiver Hierarchiegruppen (Berichts-Generator und SSRS).

Beispiel

Das folgende Codebeispiel gibt die erste Produktnummer in der Category -Gruppe eines Datenbereichs zurück:

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

Zugehöriger Inhalt

  • Last updated on