Verwenden integrierter Auflistungen in Ausdrücken (Reporting Services)

Reporting Services stellt die folgenden integrierten Auflistungen bereit, auf die Sie in einem Ausdruck verweisen können: Berichtselemente, Parameter, Felder, Datasets, Datenquellen, Variablen und integrierte Felder für globale Informationen wie Berichtsnamen. Nicht alle Auflistungen werden im Dialogfeld Ausdruck angezeigt. Die DataSets-Auflistung und die DataSources-Auflistung sind nur zur Laufzeit für veröffentlichte Berichte auf einem Berichtsserver verfügbar. Die ReportItems-Auflistung umfasst Textfelder in einem Berichtsbereich, z. B. Textfelder auf einer Seite oder in einem Seitenkopf.

Weitere Informationen finden Sie unter Grundlegendes zu Ausdrucksverweisen (Reporting Services).

Grundlegendes zu integrierten Auflistungen

In der folgenden Tabelle werden die integrierten Auflistungen, die in Reporting Services verfügbar sind, aufgelistet. Jede Zeile enthält den programmatischen Namen für die Auflistung, bei dem die Groß-/Kleinschreibung beachtet werden muss. Außerdem ist die Angabe enthalten, ob Sie über das Dialogfeld Ausdruck einen Verweis auf die Auflistung interaktiv hinzufügen können, ferner ein Beispiel und eine Beschreibung mit der Angabe, wann die Auflistungswerte initialisiert werden und verfügbar sind.

Integrierte Auflistung

Kategorie im Dialogfeld Ausdruck

Beispiel

Beschreibung

Globals

Integrierte Felder

=Globals.ReportName

- or -

=Globals.PageNumber

Stellt globale Variablen dar, die für Berichte nützlich sind, wie z. B. der Berichtsname oder die Seitenzahl. Immer verfügbar.

Weitere Informationen finden Sie unter Verwenden von integrierten Feldverweisen in Ausdrücken (Reporting Services).

User

Integrierte Felder

=User.UserID

- Oder -

=User.Language

Stellt eine Auflistung der Daten über den Benutzer dar, der den Bericht ausführt, z. B. die Spracheinstellung oder die Benutzer-ID. Immer verfügbar.

Weitere Informationen finden Sie unter Verwenden von integrierten Feldverweisen in Ausdrücken (Reporting Services).

Parameters

Parameter

=Parameters("ReportMonth").Value

- Oder -

=Parameters!ReportYear.Value

Stellt die Auflistung der Berichtsparameter dar, von denen jeder einwertig oder mehrwertig sein kann. Erst nach Abschluss der Verarbeitungsinitialisierung verfügbar. Weitere Informationen finden Sie unter Verwenden von Verweisen auf Parameters-Auflistungen in Ausdrücken (Reporting Services).

Fields(<Dataset>)

Felder

=Fields!Sales.Value

Stellt die Auflistung der im Bericht verfügbaren Felder des Datasets dar. Verfügbar, nachdem Daten aus einer Datenquelle in ein Dataset abgerufen wurden. Weitere Informationen finden Sie unter Verwenden von Verweisen auf Datasetfeldauflistungen in Ausdrücken (Reporting Services).

DataSets

Nicht angezeigt

=DataSets("TopEmployees").CommandText

Stellt die Auflistung der Datasets dar, auf die im Text einer Berichtsdefinition verwiesen wird. Enthält nicht die Datenquellen, die nur in Seitenköpfen oder Seitenfüßen verwendet werden. Nicht verfügbar in der Vorschau. Weitere Informationen finden Sie unter Verwenden von Verweisen auf DataSource- und DataSets-Auflistungen in Ausdrücken (Reporting Services).

DataSources

Nicht angezeigt

=DataSources("AdventureWorks").Type

Stellt die Auflistung der Datenquellen dar, auf die im Textkörper eines Berichts verwiesen wird. Enthält nicht die Datenquellen, die nur in Seitenköpfen oder Seitenfüßen verwendet werden. Nicht verfügbar in der Vorschau. Weitere Informationen finden Sie unter Verwenden von Verweisen auf DataSource- und DataSets-Auflistungen in Ausdrücken (Reporting Services).

Variables

Variables

=Variables!CustomTimeStamp.Value

Stellt die Auflistung von Berichtsvariablen und Gruppenvariablen dar. Weitere Informationen finden Sie unter Verwenden von Verweisen auf Berichts- und Gruppenvariablenauflistungen in Ausdrücken (Reporting Services).

ReportItems

Nicht angezeigt

=ReportItems("Textbox1").Value

Stellt die Auflistung von Textfeldern für ein Berichtselement dar. Diese Auflistung kann verwendet werden, um Elemente auf der Seite zusammenzufassen und sie in einen Seitenkopf oder einen Seitenfuß einzubeziehen. Weitere Informationen finden Sie unter Verwenden von Verweisen auf ReportItems-Auflistungen in Ausdrücken (Reporting Services).

Verwenden von Auflistungssyntax in einem Ausdruck

Wenn Sie von einem Ausdruck auf eine Auflistung verweisen möchten, können Sie die MicrosoftVisual Basic- Standardsyntax für ein Element in einer Auflistung verwenden. Die folgende Tabelle zeigt Beispiele für die Auflistungssyntax:

Syntax

Beispiel

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