Freigeben über

Verweise auf die ReportItems-Auflistung in einem paginierten Bericht (Report Builder)

  • Artikel

Gilt für: Microsoft Report Builder (SSRS) Power BI Report Builder Berichts-Designer in SQL Server Data Tools

Die integrierte ReportItems-Sammlung besteht aus Textfeldern aus Berichtselementen wie Zeilen eines Datenbereichs oder Textfeldern auf der Designoberfläche des paginierten Berichts. 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 -Sammlung verwenden, um Seitenkopfzeilen im Wörterbuchformat zu erstellen, die das erste und das letzte Element auf jeder Seite anzeigen.

Hinweis

Sie können paginierte Berichtsdefinitionsdateien (.rdl) im Berichts-Generator von Microsoft, im Power BI Report Builder und im Berichts-Designer in SQL Server-Datentools erstellen und ändern.

Verwenden Sie die ReportItems-Werteigenschaft

Elemente in der ReportItems -Auflistung verfügen nur über eine Eigenschaft: Value. 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 Textbox1an:

    =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 LastNamean:

    =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 -Sammlung 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 Referenz zu Aggregatfunktionen (Report Builder).

Zugehöriger Inhalt