Udostępnij przez


Funkcje programu Report Builder — pierwsza funkcja w raporcie podzielonym na strony (Report Builder)

Dotyczy: Microsoft Report Builder (SSRS) Power BI Report Builder Projektant raportów w narzędziu SQL Server Data Tools

Zwraca pierwszą wartość w danym zakresie określonego wyrażenia w raporcie podzielonym na strony.

Uwaga / Notatka

Pliki definicji raportu podzielonego na strony (rdl) można tworzyć i modyfikować w programie Microsoft Report Builder, programie Power BI Report Builder i w projektancie raportów w narzędziach SQL Server Data Tools.

Składnia

  
First(expression, scope)  

Parametry

expression
(Wariant lub Binarny) Wyrażenie, na którym ma być wykonywana agregacja, na przykład =Fields!FieldName.Value.

zakres
(Ciąg) Opcjonalny. Nazwa zestawu danych, grupy lub regionu danych zawierającego elementy raportu, do których ma być zastosowana funkcja agregacji. Jeśli zakres nie zostanie określony, zostanie użyty bieżący zakres.

Zwracany typ

Określana przez typ wyrażenia.

Uwagi

Funkcja First zwraca pierwszą wartość w zestawie danych po zastosowaniu wszystkich sortowania i filtrowania w określonym zakresie.

Funkcji First nie można używać w wyrażeniach filtrujących grupy z niczym innym poza aktualnym (domyślnym) zakresem.

Możesz także użyć First w nagłówku strony, aby zwrócić pierwszą wartość z kolekcji ReportItems na stronie, tworząc nagłówki w stylu słownika, które wyświetlają pierwsze i ostatnie wpisy na stronie.

Wartość zakresu musi być stałą ciągu i nie może być wyrażeniem. W przypadku agregacji zewnętrznych lub agregacji, które nie określają innych agregacji, zakres musi odwoływać się do bieżącego zakresu lub zakresu zawierającego. W przypadku agregacji agregacji zagnieżdżone agregacje mogą określać zakres podrzędny.

Wyrażenie może zawierać wywołania zagnieżdżonych funkcji agregujących z następującymi wyjątkami i warunkami:

  • Zakres zagnieżdżonych agregatów musi być taki sam jak zakres agregatu zewnętrznego lub zawierać się w nim. W przypadku wszystkich odrębnych zakresów w wyrażeniu jeden zakres musi znajdować się w relacji podrzędnej ze wszystkimi innymi zakresami.

  • Zakres zagnieżdżonych agregacji nie może być nazwą zestawu danych.

  • Wyrażenie nie może zawierać funkcji First, Last, Previous lub RunningValue .

  • Wyrażenie nie może zawierać zagnieżdżonych agregacji o charakterze rekursywnym.

Aby uzyskać więcej informacji, zapoznaj się z Odwołanie do funkcji agregujących (Report Builder i SSRS) i Zakres wyrażeń dla sum, agregacji i wbudowanych kolekcji (Report Builder i SSRS).

Aby uzyskać więcej informacji na temat cyklicznych agregacji, zobacz Creating Recursive Hierarchy Groups (Report Builder and SSRS) (Tworzenie grup hierarchii cyklicznych (Report Builder i SSRS).

Example

Poniższy przykład kodu zwraca pierwszy numer produktu w Category grupie regionu danych:

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