Verwenden integrierter Auflistungen in Ausdrücken (Report Builder 3.0 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 (Report Builder 3.0 und SSRS).
.gif "Hinweis") Hinweis |
|---|
Sie können Berichtsdefinitionen (RDL) in Berichts-Generator 3.0 und im Berichts-Designer in Business Intelligence Development Studio 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 3.0 (SSRS) im Web auf microsoft.com. |
Grundlegendes zu integrierten Auflistungen
In der folgenden Tabelle sind die integrierten Auflistungen verfügbar aufgeführt, wenn Sie einen Ausdruck schreiben. 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 globalen Werten und Benutzerverweisen (Report Builder 3.0 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 Verwenden von integrierten globalen Werten und Benutzerverweisen (Report Builder 3.0 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 Verwenden von Verweisen auf Parameterauflistungen in Ausdrücken (Report Builder 3.0 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 Verwenden von Verweisen auf Datasetfeldauflistungen (Berichts-Generator 3.0 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 Verwenden von Verweisen auf DataSource- und DataSets-Auflistungen in Ausdrücken (Report Builder 3.0 und SSRS). |
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 (Report Builder 3.0 und SSRS). |
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 (Report Builder 3.0 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 Verwenden von Verweisen auf ReportItems-Auflistungen in Ausdrücken (Report Builder 3.0 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 |
Übergeben integrierter Auflistungen an benutzerdefinierte Assemblys
Wenn Sie integrierte Sammlungen zur Verarbeitung an eine benutzerdefinierte Assembly übergeben möchten, müssen Sie dem Codeprojekt einen Assemblyverweis auf die Assembly hinzufügen, die die integrierten Auflistungen definiert, und auf den richtigen Namespace zugreifen. Je nachdem, ob Sie eine benutzerdefinierte Assembly für einen Bericht entwickeln, der auf einem Berichtsserver (Serverbericht) ausgeführt wird, oder für einen Bericht, der lokal in einer .NET-Anwendung (lokaler Bericht) ausgeführt wird, müssen Sie auf eine andere Assembly verweisen. Einzelheiten finden Sie weiter unten.
Namespace: Microsoft.ReportingServices.ReportProcessing.ReportObjectModel
Assembly (lokaler Bericht): Microsoft.ReportingServices.ProcessingObjectModel.dll
Assembly (Serverbericht): Microsoft.ReportViewer.ProcessingObjectModel.dll
Da sich der Inhalt der Auflistungen Fields und ReportItems zur Laufzeit dynamisch ändern kann, sollten Sie diese für Aufrufe der benutzerdefinierten Assembly nicht beibehalten (beispielsweise in einer Membervariablen). Diese Empfehlung gilt im Allgemeinen für alle integrierten Sammlungen.