• Artikel

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).

HinweisHinweis

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.