Wyrażenia (program Report Builder 3.0 i usługi SSRS)
Wyrażenia są powszechnie używane w raporcie w celu pobierania, obliczania, wyświetlania, grupowania, sortowania, filtrowania, parametryzowania i formatowania danych.Wyrażenie można ustawić jako wartość wielu właściwości elementów raportu.Wyrażenia pomagają w sterowaniu zawartością, projektem i interakcyjnością raportu.Expressions are written in Microsoft Visual Basic, saved in the report definition, and evaluated by the report processor when you run the report.
W odróżnieniu od aplikacji, takich jak Microsoft Office Excel, w którym praca z danych bezpośrednio w arkuszu, w raporcie, pracować z wyrażeń, które są symbolami zastępczymi dla danych.Aby zobaczyć rzeczywiste dane obliczone za pomocą wyrażeń, należy wyświetlić podgląd raportu.Po uruchomieniu raportu procesor raportów oblicza każde wyrażenie i łączy dane raportu z elementami układu raportu, takimi jak tabele lub wykresy.
Podczas projektowania raportu jest ustawianych wiele wyrażeń dla elementów raportu.Na przykład podczas przeciągania pola z okienka danych do komórki tabeli na powierzchni projektowej raportu jako wartość pola tekstowego jest przypisywane proste wyrażenie pola.Na poniższym rysunku, w okienku danych raportu wyowietlane są pola dataset ID, Name, SalesTerritory, Code, i Sales.Trzy pola zostały dodane do tabela: [Name], [Code], and [Sales].Notacja [Name] w projekcie powierzchni reprezentuje wyrażenie podstawowej =Fields!Name.Value.
.gif "Widok projektu: dane raportu i układ; okienko podglądu")
Podczas przeglądania raportu procesora raport łączy obszar tabela danych rzeczywistych z połączenie danych i wyświetla zestaw wierszy w tabela dla każdego wiersza w wyniku.
Aby ręcznie wprowadzać wyrażenia, należy zaznaczyć element na powierzchni projektowej i użyć menu skrótów oraz okien dialogowych w celu ustawienia właściwości elementu.Kiedy zobaczysz (fx) przycisku lub wartość <Expression> na liście rozwijanej wiadomo, że zestaw właściwość do wyrażenie.Aby uzyskać więcej informacji, zobacz Jak Dodać wyrażenie (Konstruktora raportów 3.0 i SSRS).
Aby uzyskać więcej informacji i zapoznać się z przykładami, zobacz następujące tematy:
Przykłady wyrażeń (program Report Builder 3.0 i usługi SSRS)
Przykłady równań filtrów (program Report Builder 3.0 i usługi SSRS)
Przykłady wyrażeń grupy (program Report Builder 3.0 i usługi SSRS)
Przykładowe raporty (program Report Builder 3.0 i usługi SSRS)
Opracowanie złożone wyrażenia lub wyrażeń korzystających z niestandardowym kodem lub niestandardowe zestawy, zaleca się używać Projektant raportów w Business Intelligence Development Studio.Aby uzyskać więcej informacji, zobacz Kod niestandardowy i odwołania do zestawów w wyrażeniach w Projektant raportów (SSRS).
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.
W tym dokumencie
Opis wyrażeń prostych i złożonych
Opis symboli prefiksów w wyrażeniach prostych
Pisanie wyrażeń złożonych
Sprawdzanie poprawności wyrażeń
W tej sekcji
Opis wyrażeń prostych i złożonych
Expressions begin with an equal sign (=) and are written in Microsoft Visual Basic.Wyrażenia mogą zawierać kombinację stałych, operatorów, odwołań do wartości wbudowanych (pola, kolekcje i funkcje) oraz do kodu zewnętrznego lub niestandardowego.
Za pomocą wyrażeń można określać wartości wielu właściwości elementów raportu.Najczęściej używanymi właściwościami są wartości pól tekstowych i tekstu zastępczego.Zazwyczaj jeśli pole tekstowe zawiera tylko jedno wyrażenie, wyrażenie stanowi wartość właściwości pola tekstowego.Jeśli pole tekstowe zawiera wiele wyrażeń, każde wyrażenie stanowi wartość tekstu zastępczego w polu tekstowym.
Domyślnie wyrażeń są wyświetlane na powierzchni projektu raportu jako proste lub złożone wyrażenia.
Prosteproste wyrażenie zawiera odwołanie do pojedynczego element kolekcja wbudowanych, na przykład pole danych parametru lub pola wbudowane.Wyrażenia proste są wyświetlane na powierzchni projektowej w nawiasach kwadratowych.Na przykład [FieldName] odpowiada podstawowej wyrażenie =Fields!FieldName.Value.Wyrażenia proste są tworzone automatycznie podczas tworzenia układu raportu i przeciągania elementów z okienka Dane raportu na powierzchnię projektową.Aby uzyskać informacje dotyczące symboli, które reprezentują różne wbudowane kolekcje, zobacz Opis symboli prefiks dla prostych wyrażeń.
Złożonezłożone wyrażenie zawiera odwołania do wielu wbudowane odwołania, operatorów i wywołania funkcja.Wyrażenie złożone jest wyświetlany jako <<wyrażenie>> , gdy wartość wyrażenia zawiera więcej niż proste odwołanie.Aby wyświetlić wyrażenie, należy umieścić na nim kursor myszy i skorzystać z etykietki narzędzia.Aby edytować wyrażenie, otwórz go w wyrażenie okno dialogowe.
Na poniższej ilustracji pokazano typowe wyrażenia proste i złożone dla pól tekstowych i tekstu zastępczego.
.gif "Wyświetlanie domyślnego formatu na powierzchni projektowej raportu")
Aby wyświetlić przykładowe wartości zamiast tekstu wyrażeń, należy zastosować formatowanie do pola tekstowego lub tekstu zastępczego.Na poniższej ilustracji pokazano powierzchnię projektową raportu, na której są widoczne przykładowe wartości:
.gif "Wyświetlanie formatu przykładowych wartości na powierzchni projektowej raportu")
Aby uzyskać więcej informacji, zobacz Formatowanie tekstu i symboli zastępczych (program Report Builder 3.0 i usługi SSRS).
.gif "Ikona strzałki używana z łączem Powrót na górę strony")
Powrót do początku
Formuły modelu raportu
Podczas projektowania kwerendy dla zestawu danych, który używa model raportu jako źródło danych można utworzyć formuły.Formuły to obliczenia wykonywane na wartościach w raporcie opartych na danych pochodzących z modelu raportu.
Aby uzyskać więcej informacji, zobacz Używanie formuł w zapytaniach modelu raportu (program Report Builder 3.0 i usługi SSRS).
Powrót do początku
Powrót do początku
Opis symboli prefiksów w wyrażeniach prostych
W wyrażeniach prostych są używane symbole wskazujące, czy odwołanie dotyczy pola, parametru, kolekcji wbudowanej, czy kolekcji ReportItems.W poniższej tabeli pokazano przykłady tekstu wyświetlanego i tekstu wyrażenia:
Element |
Przykład tekstu wyświetlanego |
Przykład tekstu wyrażenia |
|---|---|---|
Pola zestawu danych |
[Sales] [SUM(Sales)] [FIRST(Store)] |
=Fields!Sales.Value =Sum(Fields!Sales.Value) =First(Fields!Store.Value) |
Parametry raportu |
[@Param] [@Param.Label] |
=Parameters!Param.Value =Parameters!Param.Label |
Pola wbudowane |
[&ReportName] |
=Globals!ReportName.Value |
Znaki literału używane na potrzeby tekstu wyświetlanego |
\[Sales\] |
[Sales] |
Powrót do początku
Pisanie wyrażeń złożonych
Wyrażenia mogą zawierać odwołania do funkcji, operatorów, stałych pól, parametrów, elementów z kolekcji wbudowane i niestandardowego kodu osadzonego lub niestandardowe zestawy.
Ostrzeżenie
To develop complex expressions or expressions that use custom code or custom assemblies, we recommend that you use Report Designer in SQL Server Business Intelligence Development Studio.Aby uzyskać więcej informacji, zobacz Kod niestandardowy i odwołania do zestawów w wyrażeniach w Projektant raportów (SSRS).
W poniższej tabeli wymieniono rodzaje odwołań, jakich można używać w wyrażeniach:
Odwołania |
Opis |
Przykład |
|---|---|---|
Opis stałych dostęp można uzyskać interaktywnie właściwości wymagających stała wartości, takich jak kolory czcionki. |
="Blue" |
|
Opis operatorów, za pomocą których można łączyć odwołania w wyrażeniu.Na przykład & używany jest operator concatenating ciągów. |
="The report ran at: " & Globals!ExecutionTime & "." |
|
Opisuje wbudowane kolekcje, które może zawierać wyrażenie, takie jak Fields, Parameters, i Variables. |
=Fields!Sales.Value =Parameters!Store.Value =Variables!MyCalculation.Value |
|
Zawiera opis funkcje wbudowane, takich jak Sum lub Previous, który można uzyskać dostęp z wyrażenie. |
=Previous(Sum(Fields!Sales.Value)) |
|
Kod niestandardowy i odwołania do zestawów w wyrażeniach w Projektant raportów (SSRS) |
W tym artykule opisano, jak można uzyskać dostęp do wbudowanych klas CLR Math i Convert, inne klasy CLR Visual Basic run -czas biblioteka funkcji lub metody z zewnętrznego wirtualny plik dziennika. Opisano, jak można uzyskać dostęp niestandardowy kod, który jest osadzony w raporcie lub skompilować i zainstalować jako niestandardowy wirtualny plik dziennika raport klient i serwer raportów. |
=Sum(Fields!Sales.Value) =CDate(Fields!SalesDate.Value) =DateAdd("d",3,Fields!BirthDate.Value) =Code.ToUSD(Fields!StandardCost.Value) |
Powrót do początku
Sprawdzanie poprawności wyrażeń
Podczas tworzenia wyrażenia dla określonej właściwości elementu raportu odwołania, które można umieścić w wyrażeniu, zależą od wartości akceptowanych przez właściwość elementu raportu oraz zakresu, w którym ta właściwość jest obliczana.Na przykład:
Domyślnie wyrażenie [Sum] oblicza sumę danych, które w chwili obliczania wyrażenia znajdują się w zakresie.W przypadku komórki tabeli zakres jest zależny od przynależności wiersza i kolumny do grup.Aby uzyskać więcej informacji, zobacz Opis zakresu wyrażeń dla sum, wartości zagregowanych i kolekcji wbudowanych (program Report Builder 3.0 i usługi SSRS).
Wartość dla Font wartość właściwość musi ocenić nazwę czcionki.
Poprawność składni wyrażeń jest sprawdzana w czasie projektowania.Sprawdzanie poprawności zakresu wyrażenia jest wykonywane podczas publikowania raportu.W przypadku sprawdzania poprawności zależnego od rzeczywistych danych błędy mogą być wykrywane tylko w czasie działania.Niektóre wyrażenia generują ciąg #Błąd, który pełni funkcję komunikatu o będzie w renderowanym raporcie.Aby określić problemy tego rodzaju błąd, należy użyć Projektant raportów w Business Intelligence Development Studio.Narzędzie Report Designer oferuje okno Wyniki, w którym jest dostępnych więcej informacji dotyczących tych błędów.
Aby uzyskać więcej informacji, zobacz Kompendium wyrażeń (program Report Builder 3.0 i usługi SSRS).
Powrót do początku
W tej sekcji
Jak Dodać wyrażenie (Konstruktora raportów 3.0 i SSRS)
Używanie wyrażeń (program Report Builder 3.0 i usługi SSRS)
Kompendium wyrażeń (program Report Builder 3.0 i usługi SSRS)
Powrót do początku
Zobacz także