Integrierte Auflistungen in Ausdrücken (Berichts-Generator und SSRS)

Sie können Verweise auf die folgenden integrierten Auflistungen in einen Ausdruck in einem Bericht aufnehmen: 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 Ausdrücke (Berichts-Generator und SSRS).

HinweisHinweis

Sie können Berichtsdefinitionen (RDL) in Berichts-Generator und im Berichts-Designer in SQL Server-Datentools erstellen und ändern. Jede Erstellungsumgebung bietet verschiedene Methoden zum Erstellen, Öffnen und Speichern von Berichten und verwandten Elementen. Weitere Informationen finden Sie unter Entwerfen von Berichten in Berichts-Designer und Berichts-Generator (SSRS) im Web auf microsoft.com.

Grundlegendes zu integrierten Auflistungen

In der folgenden Tabelle sind die integrierten Auflistungen aufgeführt, die beim Schreiben eines Ausdrucks verfügbar sind. 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 Integrierte globale Werte und Benutzerverweise (Berichts-Generator und SSRS).

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 Integrierte globale Werte und Benutzerverweise (Berichts-Generator und SSRS).

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 Verweise auf Parameters-Auflistungen (Berichts-Generator und SSRS).

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 Verweise auf Datasetfeldauflistungen (Berichts-Generator und SSRS).

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 Verweise auf DataSources- und DataSets-Auflistungen (Berichts-Generator und SSRS).

DataSources

Nicht angezeigt

=DataSources("AdventureWorks2012").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 Verweise auf DataSources- und DataSets-Auflistungen (Berichts-Generator und SSRS).

Variables

Variables

=Variables!CustomTimeStamp.Value

Stellt die Auflistung von Berichtsvariablen und Gruppenvariablen dar. Weitere Informationen finden Sie unter Verweise auf Berichts- und Gruppenvariablenauflistungen (Berichts-Generator und SSRS).

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 Verweise auf ReportItems-Auflistungen (Berichts-Generator und SSRS).

Verwenden von Auflistungssyntax in einem Ausdruck

Wenn Sie von einem Ausdruck auf eine Auflistung verweisen möchten, können Sie die Microsoft Visual 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

Siehe auch

Aufgaben

Hinzufügen eines Ausdrucks (Berichts-Generator und SSRS)

Verweis

Beispiele für Ausdrücke (Berichts-Generator und SSRS)