Udostępnij przez

Odwołania do kolekcji parametrów 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

Parametry raportu stronicowanego to jedna z wbudowanych kolekcji, do których można się odwołać za pomocą wyrażenia. Uwzględniając parametry w wyrażeniu, można dostosować dane raportu i wygląd w oparciu o wybory dokonane przez użytkownika. Wyrażenia mogą być używane dla dowolnej właściwości elementu raportu lub właściwości pola tekstowego, która udostępnia (*Fx) lub <Expression> opcję. Wyrażenia są również używane do kontrolowania zawartości i wyglądu raportu na inne sposoby. Aby uzyskać więcej informacji, zobacz Przykłady wyrażeń (Report Builder).

Podczas porównywania wartości parametrów z wartościami pól zestawu danych w czasie wykonywania typy danych dla dwóch porównywanych elementów muszą być takie same. Parametry raportu mogą być jednym z następujących typów: wartość logiczna, data/godzina, liczba całkowita, zmiennoprzecinkowa lub tekst reprezentująca podstawowy typ danych Ciąg. W razie potrzeby może być konieczne przekonwertowanie typu danych wartości parametru na wartość zestawu danych. Aby uzyskać więcej informacji, zobacz Typy danych w wyrażeniach (Report Builder).

Aby uwzględnić odwołanie do parametrów w wyrażeniu, musisz zrozumieć, jak określić poprawną składnię odwołania do parametrów. Składnia różni się w zależności od tego, czy parametr jest parametrem jednowartościowym, czy wielowartościowym.

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.

Używanie parametru jednowartego w wyrażeniu

W poniższej tabeli przedstawiono przykłady składni używanej podczas dołączania odwołania do parametru pojedynczej wartości dowolnego typu danych w wyrażeniu.

Example Description
=Parameters! <ParameterName> .IsMultiValue Zwraca wartość False.

Sprawdza, czy parametr jest wielowartościowy. Jeśli Prawda, parametr jest wielowartościowy i stanowi kolekcję obiektów. Jeśli wartość False, parametr jest pojedynczą wartością i jest pojedynczym obiektem.
=Parameters! <ParameterName> .Count Zwraca wartość całkowitą 1. W przypadku parametru z jedną wartością liczba jest zawsze 1.
=Parameters! <ParameterName> .Label Zwraca etykietę parametru, często używaną jako nazwa wyświetlana na liście dostępnych wartości.
=Parameters! <ParameterName> .Value Zwraca wartość parametru. Jeśli właściwość Label nie została ustawiona, ta wartość zostanie wyświetlona na liście dostępnych wartości.
=CStr(Parameters! <ParameterName> .Value) Zwraca wartość parametru jako ciąg.
=Fields(Parameters! <ParameterName> .Value).Value Zwraca wartość pola, które ma taką samą nazwę jak parametr.

Aby uzyskać więcej informacji na temat używania parametrów w filtrze, zobacz Dodawanie filtrów zestawów danych, filtrów regionów danych i filtrów grup (Report Builder).

Używanie parametru wielowartościowego w wyrażeniu

W poniższej tabeli przedstawiono przykłady składni używanej podczas dołączania odwołania do parametru wielowartościowego dowolnego typu danych w wyrażeniu.

Example Description
=Parameters! <MultivalueParameterName> .IsMultiValue Zwraca wartość True lub False.

Sprawdza, czy parametr jest wielowartościowy. Jeśli wartość True, parametr jest wielowartościowy i jest kolekcją obiektów. Jeśli wartość False, parametr jest jednowarty i jest pojedynczym obiektem.
=Parameters! <MultivalueParameterName> .Count Zwraca wartość całkowitą.

Odnosi się do liczby wartości. W przypadku parametru z jedną wartością liczba jest zawsze 1. W przypadku parametru wielowartościowego liczba jest 0 lub większa.
=Parameters! <MultivalueParameterName> .Value(0) Zwraca pierwszą wartość w parametrze wielowartościowym.
=Parameters! <MultivalueParameterName> .Value(Parameters! <MultivalueParameterName> .Count-1) Zwraca ostatnią wartość w parametrze wielowartościowym.
=Split("Value1,Value2,Value3",",") Zwraca tablicę wartości.

Utwórz tablicę wartości dla parametru Ciągu wielowartościowego. Możesz użyć dowolnego ogranicznika w drugim parametrze do podziału. To wyrażenie może służyć do ustawiania wartości domyślnych dla parametru wielowartościowego lub tworzenia parametru wielowartościowego do wysyłania do podraportu lub raportu przeglądania szczegółowego.
=Join(Parameters! <MultivalueParameterName> .Value,", ") Zwraca ciąg składający się z rozdzielanej przecinkami listy wartości w parametrze wielowartościowym. Możesz użyć dowolnego ogranicznika w drugim parametrze do sprzężenia.

Aby uzyskać więcej informacji na temat używania parametrów w filtrze, zobacz Parametry raportu (Report Builder i Projektant raportów).

Treści powiązane

  • Last updated on