Share via


Erstellen von Client-Berichtsdefinitionsdateien (RDLC)

Das ReportViewer-Steuerelement unterstützt einen lokalen Verarbeitungsmodus, mit dem Sie Client-Berichtsdefinitionsdateien (RDLC) mithilfe der integrierten Verarbeitungsfunktionalität des Steuerelements ausführen können. Die Clientberichte, die Sie im lokalen Verarbeitungsmodus ausführen, können problemlos im Anwendungsprojekt erstellt werden. Es gibt vier Möglichkeiten, den Bericht zu erstellen:

  • Sie können mit dem Berichts-Assistenten eine neue Client-Berichtsdefinitionsdatei (.rdlc) erstellen.

  • Sie können in Visual Studio eine neue Client-Berichtsdefinitionsdatei (.rdlc) erstellen.

  • Sie können eine vorhandene Berichtsdefinitionsdatei (.rdl) in das Format von Client-Berichtsdefinitionsdateien (.rdlc) konvertieren, das im lokalen Verarbeitungsmodus verwendet wird.

  • Sie können eine Berichtsdefinition programmgesteuert generieren.

Um eine vorhandene Berichtsdefinition zu verwenden, fügen Sie dem Anwendungsprojekt ein Berichtselement hinzu. Wenn Sie im Menü Projekt den Befehl Neues Element hinzufügen auswählen, können Sie Berichtsvorlage auswählen, um ein Berichtslayout auf Grundlage eines leeren Berichts zu erstellen. Um einen neuen Bericht zu erstellen, klicken Sie bei der Konfiguration des ReportViewer-Steuerelements auf Neuen Bericht entwerfen. Hierdurch wird ein leerer Bericht geöffnet.

Erstellen eines lokalen Berichts und Anzeigen einer Vorschau

  1. Öffnen Sie in Microsoft Visual Studio 2008 das Anwendungsprojekt bzw. die Website.

  2. Erstellen Sie die Datenquellen, die Sie verwenden möchten. Sie können Datentabellen oder Geschäftsobjekte verwenden, die in den im Projekt verfügbaren Datasets definiert sind. Weitere Informationen finden Sie unter Erstellen von Datenquellen für einen Bericht.

  3. Erstellen Sie eine Berichtsdefinitionsdatei (RDLC), die im Projekt verwendet werden soll.

  4. Definieren Sie ein Berichtslayout, indem Sie Tabellen, Textfelder, Matrizen, Listen oder Diagramme aus der Toolbox zum leeren Bericht hinzufügen. Diese Elemente werden Datenbereiche genannt. Datenbereiche werden an Datenquellen gebunden. Genauer gesagt wird jede Zelle in einem Datenbereich einem Feld in der Datenquelle zugeordnet. Weitere Informationen finden Sie unter Hinzufügen von Datenbereichen zu einem Bericht (Visual Studio-Berichts-Designer).

  5. Stellen Sie den Bericht fertig, indem Sie Stilelemente, Formatierung, Bilder, Rahmen, Kopf- und Fußzeilen, Sortierfunktionen und andere Funktionalität hinzufügen. Weitere Informationen finden Sie unter Definieren eines Berichtslayouts (Visual Studio-Berichts-Designer).

  6. Wählen Sie das Formular oder die Seite aus, das bzw. die das Steuerelement enthalten wird.

  7. Fügen Sie der Webseite oder dem Formular im grafischen Entwurfsmodus ein ReportViewer-Steuerelement hinzu. Das ReportViewer-Steuerelement befindet sich im Abschnitt Daten der Toolbox. Weitere Informationen finden Sie unter Hinzufügen und Konfigurieren der ReportViewer-Steuerelemente.

  8. Legen Sie die Größe und die Position des Steuerelements auf der Seite oder dem Formular fest.

  9. Wählen Sie im Smarttagbereich ReportViewer-Aufgaben die von Ihnen erstellte Client-Berichtsdefinitionsdatei (RDLC) aus, um den Bericht an das Steuerelement zu binden. Weitere Informationen zum Öffnen des Smarttagbereichs finden Sie unter Verwenden des Smarttagbereichs ReportViewer-Aufgaben.

Zum Anzeigen einer Vorschau des Berichts können Sie einen Build der Anwendung erstellen oder die Anwendung bereitstellen. Sie können die Vorschau eines Berichts nur anzeigen, indem Sie ihn in einem ReportViewer-Steuerelement ausführen. Es gibt keinen eigenen Vorschaumodus für die RDLC-Datei. Sie können die Berichtsdefinition jederzeit öffnen und ändern und dann einen Build der Anwendung erstellen oder sie bereitstellen, um die Ergebnisse zu überprüfen.

Hinzufügen eines neuen Berichtselements zu einem Projekt

Wenn Sie einem Projekt ein neues Berichtselement hinzufügen, wird ein leerer Bericht erstellt und die Datei Report.rdlc dem Projekt hinzugefügt. Die Berichtsdefinitionsdatei wird im grafischen Entwurfsmodus geöffnet. Der Berichtsobjekt-Namespace wird dem Projekt hinzugefügt, und die verfügbaren Berichtssteuerelemente werden der Toolbox hinzugefügt.

Hinzufügen eines Berichtselements zu einem Bericht

Sie können einfache Berichte sehr leicht erstellen, indem Sie Berichtselemente (z. B. Textfelder, Tabellen, Diagramme und Bilder) auf eine Berichtsentwurfsoberfläche ziehen und Eigenschaften für diese Elemente festlegen.

Ein komplexerer Bericht hingegen kann Parameter und Ausdrücke enthalten, mit deren Hilfe Sie die Berichtsausgabe anpassen. Wenn Sie z. B. einen Marktanalysebericht für eine bestimmte Aktie erstellen möchten, müssen Sie dem Bericht einen Parameter hinzufügen, um das Aktiensymbol anzugeben. Sie können in der Anwendung eine Benutzeroberfläche bereitstellen, über die ein Parameterwert vom Benutzer abgefragt wird. Parameter können an die Abfrage übergeben werden, um die Datenauswahlkriterien zu präzisieren, oder zum Filtern eines Resultsets verwendet werden, sodass nur ein Teil des Resultsets im Berichts angezeigt wird. Parameterwerte können vordefiniert und von der Anwendung übergeben oder vor der Ausführung des Berichts vom Benutzer angegeben werden.

Mithilfe von Ausdrücken, die immer in Microsoft Visual Basic geschrieben werden, werden Daten aggregiert oder bedingte Formatierungen angewendet. Berichte können auch benutzerdefinierten Code enthalten. Sie können benutzerdefinierten Code in einen Bericht einbetten oder Methoden in einer benutzerdefinierten Assembly aufrufen, die Teil der Anwendung ist. Im Gegensatz zu Ausdrücken kann benutzerdefinierter Code auch in anderen Sprachen als Visual Basic geschrieben werden.

Siehe auch

Konzepte

Verwenden des Smarttagbereichs ReportViewer-Aufgaben
Erstellen von Datenquellen für einen Bericht
Definieren eines Berichtslayouts (Visual Studio-Berichts-Designer)
Übersicht über Berichte (Visual Studio)
Bereitstellen von Berichten und ReportViewer-Steuerelementen
Hinzufügen und Konfigurieren der ReportViewer-Steuerelemente
Erstellen von Clientberichtsdefinitionen mithilfe des Berichts-Assistenten von Visual Studio

Weitere Ressourcen

Beispiele und Anleitungen