Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gibt den ersten Wert im festgelegten Bereich des angegebenen Ausdrucks zurück.
Hinweis
Sie können Berichtsdefinitionen (RDL) im Berichts-Generator und im Berichts-Designer in SQL Server-Datentools erstellen und ändern. Jede Erstellungsumgebung bietet verschiedene Möglichkeiten zum Erstellen, Öffnen und Speichern von Berichten und verwandten Elementen. Weitere Informationen finden Sie unter Entwerfen von Berichten im Berichts-Designer und Berichts-Generator (SSRS) im Web unter microsoft.com.
Syntax
First(expression, scope)
Die Parameter
Ausdruck
(Variant oder Binary) Der Ausdruck, für den die Aggregation ausgeführt werden soll, zum Beispiel =Fields!FieldName.Value.
Bereich
(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.
Rückgabetyp
Wird durch den Typ des Ausdrucks bestimmt.
Bemerkungen
Die First Funktion gibt den ersten Wert in einer Datenmenge zurück, nachdem alle Sortier- und Filtervorgänge auf den angegebenen Bereich angewendet wurden.
Die First Funktion kann nicht in Gruppenfilterausdrücken mit ausnahme des aktuellen (Standardbereichs) verwendet werden.
Sie können auch First in einer Seitenkopfzeile verwenden, um den ersten Wert aus der ReportItems Auflistung für eine Seite zurückzugeben, um Überschriften im Wörterbuchformat zu erstellen, die die ersten und letzten Einträge auf einer Seite anzeigen.
Der Wert des Bereichs muss eine Zeichenfolgenkonstante sein und kann 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. Bei Aggregaten von Aggregaten können geschachtelte Aggregate einen untergeordneten Bereich angeben.
DasExpression -Objekt kann Aufrufe von geschachtelten Aggregatfunktionen enthalten. Dabei gelten folgende Ausnahmen und Bedingungen:
DasScope -Objekt für geschachtelte Aggregate muss dem Bereich des äußeren Aggregats entsprechen oder darin enthalten sein. In allen eindeutigen Bereichen des Ausdrucks muss ein Bereich eine untergeordnete Beziehung zu allen anderen Bereichen haben.
DasScope -Objekt für geschachtelte Aggregate darf nicht der Name eines Datasets sein.
Ausdruck darf die Funktionen
First,Last,PreviousoderRunningValuenicht enthalten.DasExpression -Objekt darf keine geschachtelten Aggregate enthalten, die ein recursive-Objekt 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")
Siehe auch
Ausdrucksverwendungen in Berichten (Berichts-Generator und SSRS)
Beispiele für Ausdrücke (Berichts-Generator und SSRS)
Datentypen in Ausdrücken (Berichts-Generator und SSRS)
Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS)