Freigeben über


Aktualisieren und erneutes Binden von Datenquellenverweisen (Visual Studio-Berichts-Designer)

Das ReportViewer-Steuerelement und die Client-Berichtsdefinitionsdatei (RDLC) schließen Verweise zu den Datenquellen ein, die Daten für den Bericht bereitstellen. Wenn Sie Berichtsdefinitionen konvertieren, ein Dataset hinzufügen oder löschen oder ein Dataset ändern, das in einem Bericht verwendet wird, müssen Sie alle Datenquellenverweise und -bindungen aktualisieren, bevor Sie die Anwendung bereitstellen oder ausführen.

Übersicht über Datenquellenverweise, die von ReportViewer-Steuerelementen und Berichten verwendet werden

Datenquelleninformationen werden auf unterschiedliche Weise von den Steuerelementen und Berichten verwendet. Einerseits verwendet die Berichtsdefinition eingebettete Schemainformationen, um die Zuordnung zwischen Elementen im Berichtslayout und den Daten herzustellen, die schließlich im Layout zusammengeführt werden. Darüber hinaus sind Datenquellenbindungen für das ReportViewer-Steuerelement erforderlich, damit Sie zur Laufzeit Daten an das Steuerelement übergeben können.

Zur Laufzeit müssen alle Bindungen und Datenquelleinformationen synchronisiert sein, damit der Bericht die erwarteten Daten enthält. Eine Reihe von Optionen soll dazu beitragen, dass die Datenquelleninformationen während des ganzen Entwicklungszyklus auch dann synchronisiert bleiben, wenn Sie die Berichte und Datasets ändern, die in der Anwendung verwendet werden. In der folgenden Liste werden die verschiedenen verfügbaren Optionen zusammengefasst:

  • Verwenden Sie die Aufgabe Datenquellen auswählen im Smarttagbereich ReportViewer-Aufgaben, um eine Datenquelle an eine Client-Berichtsdefinitionsdatei (RDLC) zu binden, die Sie durch Konvertieren einer Server-Berichtsdefinitionsdatei (RDL) erstellt haben.

  • Verwenden Sie die Aufgabe Datenquellen erneut binden im Smarttagbereich ReportViewer-Aufgaben, um das Steuerelement und die Berichtsdefinition mit den geänderten Datasets zu synchronisieren.

  • Verwenden Sie das Dialogfeld Berichtsdatenquellen, das über das Menü Bericht aufgerufen wird, um die in der Berichtsdefinitionsdatei gespeicherten Schemainformationen zu aktualisieren. Das Menü Bericht ist verfügbar, wenn Sie eine Client-Berichtsdefinitionsdatei (RDLC) im grafischen Entwurfsmodus bearbeiten.

Aktualisieren von Datenquellenverweisen in einer Berichtsdefinition

Die Berichtsdefinition enthält Datasetelemente, die die vom Bericht verwendete Datenquellenstruktur definieren. Die Datasetelemente werden während des Berichtsentwurfs zur Berichtsdefinition hinzugefügt. Sobald Sie ein bestimmtes Feld in einen Datenbereich oder in ein Textfeld im Bericht ziehen, wird ein neues Element hinzugefügt.

Die Aktualisierung der Berichtsdefinition ist erforderlich, wenn Sie Berichtsdefinitionsdateien zwischen Projekten kopieren, die verschiedene Datenquellen verwenden, oder wenn Sie die im Projekt verwendeten Datasets geändert haben. Wenn Sie das tatsächlich im Projekt verwendete Dataset anschließend ändern, indem Sie Felder oder Tabellen entfernen oder umbenennen, sind die Verweise in der Berichtsdefinition nicht mehr gültig. Zum Aktualisieren der Berichtsdefinition verwenden Sie das Dialogfeld Datenquellen gemäß der Beschreibung in den folgenden Schritten.

Aktualisieren von Verweisen in einer Berichtsdefinition

  1. Öffnen Sie die Client-Berichtsdefinitionsdatei (RDLC) im grafischen Entwurfsmodus.

  2. Wählen Sie im Menü Bericht den Befehl Datenquellen aus. Das Dialogfeld Berichtsdatenquellen wird angezeigt. Sie können die folgenden Optionen verwenden:

    • Wählen Sie eine Projektdatenquelle aus, und klicken Sie auf Dem Bericht hinzufügen, um der Berichtsdefinition ein neues Dataset hinzuzufügen. In den meisten Fällen wird diese Option nicht benötigt. Projektdatenquellen werden automatisch zur Berichtsdefinition hinzugefügt, wenn Sie Felder in das Berichtslayout ziehen.

    • Wählen Sie das Dataset aus, und klicken Sie auf Entfernen, um einen vorhandenen Datasetverweis aus der Berichtsdefinition zu entfernen.

    • Wenn Sie ein Dataset im Projekt umbenannt haben, können Sie das Dialogfeld Berichtsdatenquellen verwenden, um den Datasetnamen in der Berichtsdefinition zu aktualisieren. Klicken Sie auf die Schaltfläche Umbenennen, um den Überschreibungsmodus für den Datasetnamen festzulegen, und geben Sie dann den neuen Namen ein.

  3. Klicken Sie auf Alle aktualisieren, um die Berichtsdefinitionsdatei mit Ihren Änderungen zu aktualisieren.

Erneutes Binden von Datenquellen an das ReportViewer-Steuerelement

Für das ReportViewer-Steuerelement sind Datenbindungen erforderlich, damit der Zugriff auf Anwendungsdatenquellen zur Laufzeit möglich ist. Datenbindungen werden für das Steuerelement erstellt, wenn Sie eine Client-Berichtsdefinitionsdatei (RDLC) auswählen.

Das erneute Binden einer Datenquelle ist notwendig, wenn Sie eine Berichtsdefinitionsdatei ändern, die bereits an ein Steuerelement gebunden wurde, wenn Sie das Dataset ändern, nachdem das Steuerelement an ein Formular oder eine Webseite gebunden wurde, oder wenn Sie ein neues Dataset zum Bericht hinzufügen. Jede dieser Aktionen bewirkt, dass Bindungen nicht mehr aktuell sind. Verwenden Sie die Aufgabe Datenquellen erneut binden im Smarttagbereich ReportViewer-Aufgaben, um die Datenbindungen im Anwendungscode zu aktualisieren.

NoteHinweis

Nicht bei allen Änderungen an einer Berichtsdefinition ist das erneute Binden einer Datenquelle erforderlich. Das Neuordnen oder Formatieren von Elementen oder die erneute Verwendung desselben datengebundenen Felds in mehreren Datenbereichen sind Beispiele für Änderungen, durch die vorhandene Datenbindungen nicht ungültig werden. Wenn Sie einen Teil der Datenquelle ändern, der nicht im Bericht verwendet wird, müssen Sie die Bindungen ebenfalls nicht aktualisieren.

Erneutes Binden von Datenquellen

  1. Öffnen Sie das Formular oder die Webseite, das bzw. die das ReportViewer-Steuerelement enthält.

  2. Klicken Sie im Smarttagbereich ReportViewer-Aufgaben auf Datenquellen erneut binden. Sie können den Code überprüfen, der dem Formular oder der Seite zugrunde liegt, um die Änderungen zu bestätigen.

Auswählen von Datenquellen für das ReportViewer-Steuerelement

Wenn Sie eine Server-Berichtsdefinitionsdatei (RDL) in eine Client-Berichtsdefinitionsdatei konvertieren, müssen Sie sicherstellen, dass die Anwendung Datenbindungscode für das ReportViewer-Steuerelement einschließt. Der Datenbindungscode wird automatisch generiert, wenn Sie eine RDLC-Datei anhand einer Berichtsvorlage erstellen. Der Datenbindungscode ist jedoch nicht vorhanden, wenn Sie die RDLC-Datei auf andere Weise erstellen. Zum Hinzufügen des Datenbindungscodes verwenden Sie die Aufgabe Datenquellen auswählen im Smarttagbereich ReportViewer-Aufgaben. Weitere Informationen zum Konvertieren von Berichtsdefinitionen finden Sie unter Konvertieren von RDL- und RDLC-Dateien.

Hinzufügen von Datenquellenbindungen

  1. Öffnen Sie das Formular oder die Webseite, das bzw. die das ReportViewer-Steuerelement enthält.

  2. Klicken Sie im Smarttagbereich ReportViewer-Aufgaben auf Datenquellen auswählen. Sie können den Code, der dem Formular oder der Seite zugrunde liegt, überprüfen, um die Änderungen zu bestätigen.

Siehe auch

Konzepte

Erstellen von Client-Berichtsdefinitionsdateien (RDLC)
Erstellen von Datenquellen für einen Bericht
Verwenden des Smarttagbereichs ReportViewer-Aufgaben
Konfigurieren von ReportViewer für die lokale Verarbeitung