Verweise auf ReportItems-Auflistungen (Berichts-Generator und SSRS)

Die integrierte ReportItems-Auflistung besteht aus einem Satz von Textfeldern aus Berichtselementen, wie Zeilen eines Datenbereichs oder Textfelder auf der Berichtsentwurfsoberfläche. Die ReportItems-Auflistung umfasst Textfelder, die sich im aktuellen Bereich einer Seitenkopfzeile, einer Seitenfußzeile oder eines Berichtshauptteils befinden. Diese Auflistung wird vom Berichtsprozessor und vom Berichtsrenderer zur Laufzeit bestimmt. Der aktuelle Bereich wird geändert, wenn der Berichtsprozessor Berichtsdaten und die Layoutelemente des Berichtselements erfolgreich kombiniert, während der Benutzer Seiten eines Berichts anzeigt. Sie können die integrierte ReportItems-Auflistung verwenden, um Seitenkopfzeilen im Wörterbuchformat zu erstellen, die das erste und das letzte Element auf jeder Seite anzeigen.

Hinweis

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.

Verwenden der ReportItems-Werteigenschaft

Elemente in der ReportItems-Auflistung verfügen nur über eine Eigenschaft: Wert. Mit dem Wert für ein ReportItems-Element können Daten aus einem anderen Feld im Bericht angezeigt oder berechnet werden. Der Zugriff auf den Wert des aktuellen Textfelds kann über den in Visual Basic integrierten globalen Me.Value oder einfach über Value erfolgen. In Berichtsfunktionen wie "Erster" und in Aggregatfunktionen müssen Sie jedoch die vollqualifizierte Syntax verwenden.

Beispiel:

• Dieser Ausdruck wird in einem Textfeld platziert und zeigt den Wert eines ReportItem-Textfelds mit dem Namen Textbox1 an:

  =ReportItems!Textbox1.Value

• Dieser Ausdruck wird in der Color-Eigenschaft eines ReportItem-Textfelds platziert und zeigt den Text in Schwarz an, wenn der Wert > 0 ist. Andernfalls wird der Wert in Rot angezeigt:

  =IIF(Me.Value > 0,"Black","Red")

• Dieser Ausdruck wird in einem Textfeld des Seitenkopfes oder Seitenfußes platziert und zeigt den ersten Wert pro Seite des gerenderten Berichts für ein Textfeld mit dem Namen LastName an:

  =First(ReportItems("LastName").Value)

Seitenkopfausdrücke im Wörterbuchformat

Sie können einen Seitenkopf erstellen, der den ersten Kunden auf der Seite und den letzten Kunden auf der Seite anzeigt. Da ein Textfeld im Seitenkopf nur einmal auf die integrierte ReportItems-Auflistung verweisen kann, müssen Sie dem Seitenkopf zwei Textfelder hinzufügen: ein Feld für den Namen des ersten Kunden (=First(ReportItems!textboxLastName.Value) und ein Feld für den Namen des letzten Kunden (=Last(ReportItems!textboxLastName.Value).

In einem Seitenkopf- oder Seitenfußabschnitt sind nur Textfelder auf der aktuellen Seite als Elemente der ReportItems-Auflistung verfügbar. Wenn ReportItems!textboxLastName.Value beispielsweise auf ein Textfeld verweist, das nur auf der ersten Seite eines mehrseitigen Datenbereichs angezeigt wird, wird ein Wert für die erste Seite angezeigt. Alle anderen Seiten enthalten jedoch die Meldung #Error, die angibt, dass der Ausdruck nicht als geschrieben ausgewertet werden konnte.

Bereich der ReportItems-Auflistung

Während der Bericht verarbeitet wird, wird jedes Textfeld im Berichtshauptteil oder in einem Datenbereich im Kontext des entsprechenden Datasets, des Datenbereichs und der Gruppenzuordnungen ausgewertet. Der Bereich für einen Verweis auf die ReportItems-Auflistung ist der aktuelle Bereich oder jeder Punkt, der höher liegt als der aktuelle Bereich.

Ein Textfeld in einer Zeile, die sich in einer übergeordneten Gruppe befindet, darf beispielsweise keinen Ausdruck enthalten, der auf den Namen eines Textfelds in einer Zeile einer untergeordneten Gruppe verweist. Ein solcher Ausdruck wird nicht in einen Wert des Berichts aufgelöst, da sich das Textfeld in der untergeordneten Zeile außerhalb des Bereichs befindet. Weitere Informationen finden Sie unter Aggregatfunktionsreferenz (Berichts-Generator und SSRS).

Siehe auch

Verweis

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

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

Konzepte

Paginierung in Reporting Services (Berichts-Generator und SSRS)

Filtern, Gruppieren und Sortieren von Daten (Berichts-Generator und SSRS)