Udostępnij za pośrednictwem

  • Artykuł

Używanie odwołań do kolekcji Parameters (program Report Builder 3.0 i usługi SSRS)

Parametry raportu to jedna z kolekcji wbudowanych, do których można odwoływać się w wyrażeniach.Uwzględniając parametry w wyrażeniu, można dostosować dane i wygląd raportu na postawie opcji wybranych przez użytkownika.Wyrażenia mogą być używane do dowolnego element raportu właściwość lub właściwość pole tekstu, która zapewnia (Fx) lub <wyrażenie> opcji.Wyrażenia są również często używane w celu sterowania zawartością i wyglądem raportu innymi metodami.Aby uzyskać więcej informacji, zobacz Przykłady wyrażeń (program Report Builder 3.0 i usługi SSRS).

Podczas porównywania wartości parametru z wartościami pól zestawu danych w czasie wykonywania oba porównywane elementy muszą mieć taki sam typ danych.Parametry raportu może być jednym z następujących typów: wartość logiczna, DateTime, liczba całkowita, Float lub tekst, który reprezentuje typ danych String.W razie potrzeby można przekonwertować typ danych wartości parametru w celu dopasowania go do wartości zestawu danych.Aby uzyskać więcej informacji, zobacz Praca z typami danych w wyrażeniach (program Report Builder 3.0 i usługi SSRS).

Aby dołączyć odwołania do parametru w wyrażenie, należy zrozumieć, jak określić poprawną składnię dla odwołania do parametru, który różni się zależnie od tego, czy parametr jest parametr pojedynczą wartość lub wielowartościowym.

Ostrzeżenie

Program Business Intelligence Development Studio umożliwia tworzenie i modyfikowanie definicji raportów (rdl) przy użyciu programów Report Builder 3.0 i Report Designer. Każde ze środowisk obsługuje różne sposoby tworzenia, otwierania i zapisywania raportów oraz powiązanych z nimi elementów. Aby uzyskać więcej informacji, zobacz temat Projektowanie raportów w programach Report Designer i Report Builder 3.0 (usługi SSRS) w witrynie sieci Web microsoft.com.

Używanie parametru jednowartościowego w wyrażeniu

W poniższej tabeli pokazano przykłady składni, której należy użyć podczas umieszczania w wyrażeniu odwołania do parametru jednowartościowego.

Przykład

Opis

=Parameters!<ParameterName>.IsMultiValue

Zwraca False.

Sprawdza, czy parametr jest wielowartościowy.Jeśli True, parametr jest wielowartościowym i kolekcja obiekty.Jeśli False, parametr jest pojedynczą wartość i jest pojedynczy obiekt.

=Parameters!<ParameterName>.Count

Zwraca wartość całkowitą równą 1.W przypadku parametru jednowartościowego ta liczba zawsze wynosi 1.

=Parameters!<ParameterName>.Label

Zwraca Etykieta parametru często używana jako nazwa wyświetlana w drop -niedziałający listę dostępnych wartości.

=Parameters!<ParameterName>.Value

Zwraca wartość parametru.Jeśli Label właściwość nie została zestaw, wartość ta jest wyświetlana na liście rozwijanej dostępne wartości.

=CStr(Parameters! <ParameterName>.Value)

Zwraca wartość parametru jako ciąg.

=Fields(Parameters!<ParameterName>.Value).Value

Zwraca wartość pole, które ma taką samą nazwę jak parametr.

Aby uzyskać więcej informacji na temat Używanie parametrów w filtrze, zobacz Dodawanie filtrów zestawów danych, filtrów obszarów danych i filtrów grup (program Report Builder 3.0 i usługi SSRS).

Używanie parametru wielowartościowego w wyrażeniu

W poniższej tabeli pokazano przykłady składni, której należy użyć podczas umieszczania w wyrażeniu odwołania do parametru wielowartościowego o dowolnym typie danych.

Przykład

Opis

=Parameters!<MultivalueParameterName>.IsMultiValue

Returns True or False.

Sprawdza, czy parametr jest wielowartościowy.Jeśli True, parametr jest wielowartościowym i kolekcja obiekty.Jeśli False, parametr jest jednowartościowego i pojedynczego obiektu.

=Parameters!<MultivalueParameterName>.Count

Zwraca wartość typu liczba całkowita.

Jest to liczba wartości.W przypadku parametru jednowartościowego ta liczba zawsze wynosi 1.W przypadku parametru wielowartościowego ta liczba wynosi 0 lub więcej.

=Parameters!<MultivalueParameterName>.Value(0)

Zwraca pierwszą wartość parametru wielowartościowego.

=Parameters!<MultivalueParameterName>.Value(Parameters!<MultivalueParameterName>.Count-1)

Zwraca ostatnią wartość parametru wielowartościowego.

=Split("Value1,Value2,Value3",",")

Zwraca tablicę wartości.

Utwórz tablicę wartości dla atrybut wielowartościowy String parametru.W drugim parametrze funkcji Split można użyć dowolnego ogranicznika.Tego wyrażenia można użyć w celu ustawienia wartości domyślnych dla parametru wielowartościowego lub utworzenia parametru wielowartościowego wysyłanego do podraportu lub raportu szczegółowego.

=Join(Parameters!<MultivalueParameterName>.Value,", ")

Zwraca String , składa się z separatorami listy wartości parametru wielowartościowym.W drugim parametrze funkcji Join można użyć dowolnego ogranicznika.

Aby uzyskać więcej informacji na temat Używanie parametrów w filtrze, zobacz Parametry (program Report Builder 3.0 i usługi SSRS).