Odwołania do kolekcji ReportItems 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

Wbudowana kolekcja ReportItems to zestaw pól tekstowych z elementów raportu, takich jak wiersze regionu danych lub pola tekstowe na powierzchni projektowej raportu podzielonego na strony. Kolekcja ReportItems zawiera pola tekstowe, które znajdują się w bieżącym zakresie nagłówka strony, stopki strony lub treści raportu. Ta kolekcja jest określana w czasie wykonywania przez procesor raportów i moduł renderowania raportów. Bieżący zakres zmienia się w miarę, gdy procesor raportów łączy dane raportu i elementy układu elementu raportu, gdy użytkownik wyświetla strony raportu. Za pomocą wbudowanej kolekcji ReportItems można tworzyć nagłówki stron w stylu słownika, które pokazują pierwsze i ostatnie elementy na każdej stronie.

Użyj właściwości Value w ReportItems

Elementy w kolekcji ReportItems mają tylko jedną właściwość: Value. Wartość elementu ReportItems może służyć do wyświetlania lub obliczania danych z innego pola w raporcie. Aby uzyskać dostęp do wartości bieżącego pola tekstowego, możesz użyć wbudowanej globalnej funkcji Me.Value Visual Basic lub po prostu Value. W funkcjach raportów, takich jak funkcje First i aggregate, użyj w pełni kwalifikowanej składni.

Przykład:

• To wyrażenie, umieszczone w polu tekstowym, wyświetla wartość pola tekstowego ReportItem o nazwie Textbox1:

  =ReportItems!Textbox1.Value

• To wyrażenie, umieszczone we właściwości Color pola tekstowego ReportItem , wyświetla tekst na czarno, gdy wartość wynosi > 0; w przeciwnym razie wartość jest wyświetlana na czerwono:

  =IIF(Me.Value > 0,"Black","Red")

• To wyrażenie, umieszczone w polu tekstowym w nagłówku strony lub stopce strony, wyświetla pierwszą wartość na stronę renderowanego raportu dla pola tekstowego o nazwie LastName:

  =First(ReportItems("LastName").Value)

Wyrażenia nagłówka strony w stylu słownika

Możesz utworzyć nagłówek strony, aby wyświetlić pierwszego klienta na stronie i ostatniego klienta na stronie. Ponieważ pole tekstowe w nagłówku strony może odwoływać się tylko do wbudowanej kolekcji ReportItems raz w wyrażeniu, należy dodać dwa pola tekstowe do nagłówka strony: jeden dla pierwszego imienia i nazwiska klienta (=First(ReportItems!textboxLastName.Value=Last(ReportItems!textboxLastName.Value).

W sekcji nagłówka lub stopki strony jako członka kolekcji ReportItems są dostępne tylko pola tekstowe na bieżącej stronie. Jeśli na przykład ReportItems!textboxLastName.Value odwołuje się do pola tekstowego, które pojawia się tylko na pierwszej stronie dla regionu danych wielostronicowych, zostanie wyświetlona wartość pierwszej strony, ale wszystkie inne strony wyświetlają #Error , aby pokazać, że wyrażenie nie może zostać ocenione jako zapisane.

Zakres kolekcji ReportItems

W miarę przetwarzania raportu każde pole tekstowe w treści raportu lub w regionie danych jest oceniane w kontekście jego zestawu danych, regionu danych i skojarzeń grup. Zakres odwołania do kolekcji ReportItems jest bieżącym zakresem lub dowolnym punktem wyższym niż bieżący zakres.

Na przykład pole tekstowe w wierszu, który znajduje się w grupie nadrzędnej, nie może zawierać wyrażenia odwołującego się do nazwy pola tekstowego w podrzędnym wierszu grupy. Takie wyrażenie nie jest rozpoznawane jako wartość w raporcie, ponieważ pole tekstowe wiersza podrzędnego jest poza zakresem. Więcej informacji znajdziesz w Odwołanie do funkcji agregujących (Report Builder).

Treści powiązane

• Wbudowane kolekcje w wyrażeniach (Report Builder)
• Przykłady wyrażeń (Report Builder)
• Stronicowanie w usługach Reporting Services (Report Builder)
• Filtrowanie, grupowanie i sortowanie danych (Report Builder)