Używanie kolekcji wbudowanych w wyrażeniach (program Report Builder 3.0 i usługi SSRS)
W wyrażenie w raporcie mogą zawierać odwołania do wbudowane następujące kolekcje: ReportItems, parametry, pól, zestawów danych, źródła danych, zmienne i pola wbudowane globalne informacje takie jak nazwa raportu.Nie wszystkie kolekcje są wyświetlane w wyrażenie okno dialogowe.Kolekcje DataSets i DataSources są dostępne tylko w czasie wykonywania dla raportów opublikowanych na serwerze raportów.Kolekcja ReportItems to kolekcja pól tekstowych w obszarze raportu, na przykład pól tekstowych na stronie lub w nagłówku strony.
Aby uzyskać więcej informacji, zobacz Wyrażenia (program Report Builder 3.0 i usługi 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.
Opis kolekcji wbudowanych
W poniższej tabeli wymieniono kolekcje wbudowane dostępne podczas pisania wyrażeń.Każdy wiersz zawiera programową nazwę kolekcji (w nazwach jest rozróżniana wielkość liter), informację, czy za pomocą okna dialogowego Wyrażenie można interakcyjnie dodać odwołanie do danej kolekcji, przykład oraz opis zawierający informacje dotyczące czasu inicjowania wartości kolekcji i ich dostępności do użycia.
Kolekcja wbudowana |
Kategoria w oknie dialogowym Wyrażenie |
Przykład |
Opis |
|---|---|---|---|
Globals |
Pola wbudowane |
=Globals.ReportName - or - =Globals.PageNumber |
Reprezentuje zmienne globalne używane w raportach, takie jak nazwa raportu czy numer strony.Zawsze dostępna. Aby uzyskać więcej informacji, zobacz Używanie odwołań do wbudowanych kolekcji Globals i Users (program Report Builder 3.0 i usługi SSRS). |
User |
Pola wbudowane |
=User.UserID - lub - =User.Language |
Reprezentuje kolekcję danych dotyczących użytkownika uruchamiającego raport, takich jak ustawienie języka lub identyfikator użytkownika.Zawsze dostępna. Aby uzyskać więcej informacji, zobacz Używanie odwołań do wbudowanych kolekcji Globals i Users (program Report Builder 3.0 i usługi SSRS). |
Parameters |
Parametry |
=Parameters("ReportMonth").Value - lub - =Parameters!ReportYear.Value |
Reprezentuje kolekcję parametrów raportu, z których każdy może być parametrem jednowartościowym lub wielowartościowym.Niedostępna do czasu ukończenia inicjowania przetwarzania.Aby uzyskać więcej informacji, zobacz Używanie odwołań do kolekcji Parameters (program Report Builder 3.0 i usługi SSRS). |
Fields(<Dataset>) |
Pola |
=Fields!Sales.Value |
Reprezentuje kolekcję pól zestawu danych, które są dostępne do użycia w raporcie.Dostępna po pobraniu danych ze źródła danych do zestawu danych.Aby uzyskać więcej informacji, zobacz Używanie odwołań do kolekcji pól zestawu danych (program Report Builder 3.0 i usługi SSRS). |
DataSets |
Niewyświetlana |
=DataSets("TopEmployees").CommandText |
Reprezentuje kolekcję zestawów danych, do których odwołania znajdują się w treści definicji raportu.Nie zawiera źródeł danych używanych tylko w nagłówkach lub stopkach stron.Niedostępna w podglądzie lokalnym.Aby uzyskać więcej informacji, zobacz Używanie odwołań do kolekcji DataSources i DataSets (program Report Builder 3.0 i usługi SSRS). |
DataSources |
Niewyświetlana |
=DataSources("AdventureWorks").Type |
Reprezentuje kolekcję źródeł danych, do których odwołania znajdują się w treści raportu.Nie zawiera źródeł danych używanych tylko w nagłówkach lub stopkach stron.Niedostępna w podglądzie lokalnym.Aby uzyskać więcej informacji, zobacz Używanie odwołań do kolekcji DataSources i DataSets (program Report Builder 3.0 i usługi SSRS). |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
Reprezentuje kolekcję zmiennych raportu i zmiennych grupy.Aby uzyskać więcej informacji, zobacz Używanie odwołań do kolekcji zmiennych raportu i zmiennych grupy (program Report Builder i usługi SSRS). |
ReportItems |
Niewyświetlana |
=ReportItems("Textbox1").Value |
Reprezentuje kolekcję pól tekstowych elementu raportu.Tej kolekcji można użyć w celu podsumowania elementów na stronie i włączenia tych podsumowań do nagłówka lub stopki strony.Aby uzyskać więcej informacji, zobacz Używanie odwołań do kolekcji ReportItems (program Report Builder 3.0 i usługi SSRS). |
Używanie składni kolekcji w wyrażeniu
To refer to a collection from an expression, use standard Microsoft Visual Basic syntax for an item in a collection.W poniższej tabeli pokazano przykłady składni kolekcji.
Składnia |
Przykład |
|---|---|
Collection!ObjectName.Property |
=Fields!Sales.Value |
Collection!ObjectName("Property") |
=Fields!Sales("Value") |
Collection("ObjectName").Property |
=Fields("Sales").Value |
Collection("Member") |
=User("Language") |
Collection.Member |
=User.Language |
Zobacz także