Using Built-in Collections in Expressions (Reporting Services)
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 Understanding Expression References (Reporting Services).
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 zobacz Using Built-in Field References in Expressions (Reporting Services). |
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 Using Built-in Field References in Expressions (Reporting Services). |
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 zobacz Using Parameters Collection References in Expressions (Reporting Services). |
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 Using Dataset Fields Collection References in Expressions (Reporting Services). |
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 Using DataSources and DataSets Collection References in Expressions (Reporting Services). |
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 Using DataSources and DataSets Collection References in Expressions (Reporting Services). |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
Reprezentuje kolekcję zmiennych raportu i zmiennych grupy.Aby uzyskać więcej informacji zobacz Using Report and Group Variables Collection References in Expressions (Reporting Services). |
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 Using the ReportItems Collection References in Expressions (Reporting Services). |
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