Używanie kolekcji wbudowanych w wyrażeniach (program Report Builder 2,0)
Reporting Services zawiera następujące kolekcje wbudowanych, które odwołują się z wyrażenie: ReportItems, parametry, pola, zestawach danych, źródła, zmienne i pola wbudowane globalnych informacji, takich 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 Opis odwołań w wyrażeniach (program Report Builder 2.0).
Opis kolekcji wbudowanych
W poniższej tabeli wymieniono kolekcje wbudowane dostępne w usługach Reporting Services.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 |
Description |
|---|---|---|---|
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 zobaczUżywanie odwołań do pól wbudowanych w wyrażeniach (program Report Builder 2.0). |
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 zobaczUżywanie odwołań do pól wbudowanych w wyrażeniach (program Report Builder 2.0). |
Parameters |
Parameters |
=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 zobaczUżywanie odwołań do kolekcji parametrów w wyrażeniach (program Report Builder 2,0). |
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 zobaczUżywanie odwołań do kolekcji pól zestawu danych w wyrażeniach (program Report Builder 2,0). |
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 zobaczUżywanie odwołań do kolekcji DataSources i DataSets w wyrażeniach (program Report Builder 2,0). |
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 zobaczUżywanie odwołań do kolekcji DataSources i DataSets w wyrażeniach (program Report Builder 2,0). |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
Reprezentuje kolekcję zmiennych raportu i zmiennych grupy.Aby uzyskać więcej informacji zobaczUżywanie w wyrażeniach odwołań do kolekcji zmiennych raportu i zmiennych grupy (program Report Builder 2,0). |
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 zobaczUżywanie odwołań do kolekcji ReportItems w wyrażeniach (program Report Builder 2,0). |
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 |
See Also