Verwenden integrierter Auflistungen in Ausdrücken (Berichts-Generator 2.0)
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 (Berichts-Generator 2.0).
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 (Berichts-Generator 2.0). |
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 (Berichts-Generator 2.0). |
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 (Berichts-Generator 2.0). |
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 (Berichts-Generator 2.0). |
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 (Berichts-Generator 2.0). |
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 (Berichts-Generator 2.0). |
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 (Berichts-Generator 2.0). |
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 (Berichts-Generator 2.0). |
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 |
Siehe auch