First-Funktion (Reporting Services)
Gibt den ersten Wert im festgelegten Bereich des angegebenen Ausdrucks zurück.
Syntax
First(expression, scope)
Parameter
expression
(Variant oder Binary) Der Ausdruck, für den die Aggregation auszuführen ist. Beispiel: =Fields!FieldName.Value Der Ausdruck kann keine Aggregatfunktionen enthalten.scope
(String) 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. Weitere Informationen finden Sie unter Verwenden von integrierten Berichts- und Aggregationsfunktionen in Ausdrücken (Reporting Services) und Berechnen von Gesamtwerten und anderen Aggregaten (Reporting Services).
Rückgabetypen
Wird durch den Typ des Ausdrucks bestimmt.
Hinweise
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 nur in Gruppenfilterausdrücken mit dem aktuellen (Standard-) Bereich 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 scope kann kein Ausdruck sein und muss auf den aktuellen Bereich oder einen enthaltenen Bereich verweisen.
Beispiel
Das folgende Codebeispiel gibt die erste Produktnummer in der Category-Gruppe eines Datenbereichs zurück:
=First(Fields!ProductNumber.Value, "Category")