Udostępnij za pośrednictwem

  • Artykuł

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