Binden an Serverdateien (Visual Studio 2005 und höher)

Objektmodell

In diesem Berichtbindungsszenario wird das CrystalReportViewer-Objektmodell verwendet (siehe Berichtbindung mit CrystalReportViewer-Objektmodell).

Ort des Berichts

Die Berichte befinden sich in einem Berichtordner im lokalen Dateiverzeichnis (siehe Verzeichnis "Samples"). Berichte an diesem Speicherort werden als Berichtswebdienste verfügbar gemacht.

Übersicht über Serverdateien

Dieses Berichtbindungsszenario bezieht sich auf Berichte, auf die als Serverdateien über einen Webdienst zugegriffen wird.

NoteAnmerkung

Eine Übersicht der Crystal Services finden Sie unter Verwenden von Crystal Services.

Beschreibung

Über den Webdienst "Serverdateien" greifen Sie auf Berichte zu, die als Berichtswebdienste von einem lokalen Dateiverzeichnis verfügbar gemacht wurden, und lassen sie anzeigen. In Visual Studio 2005 und höher wird auf Serverdateien programmgesteuert zugegriffen.

Eine Vergleichstabelle zu Crystal Services finden Sie unter CrystalReportViewer-Bindungsszenarien mit Verwendung von Crystal Services und unter ReportDocument-Bindungsszenarien mit Verwendung von Crystal Services (VS .NET 2002 und 2003).

Pro

  • Zentraler Zugriff auf Berichte: Bietet einen zentralen Zugriffspunkt auf alle Berichte in Ihrem Musterberichtverzeichnis (siehe Verzeichnis "Samples"), wodurch ein effizientes Bericht-Repository auf Ihrem lokalen Festplattenlaufwerk entsteht.

Contra

Konfigurieren von Serverdateien

In Crystal Reports für Visual Studio wird auf Serverdateien programmgesteuert zugegriffen. Jede Edition von Was ist Crystal Reports für Visual Studio? bietet weiterhin programmgesteuerte Unterstützung für Serverdateien im SDK.

Ausführliche Informationen zur Konfiguration der Serverdateien finden Sie unter Konfigurieren der Serverdateien in Visual Studio 2005 oder 2008.

So codieren Sie die Serverdateien manuell

  • Ein Berichtswebdienst, der programmgesteuerten Zugriff auf Serverdateien zulässt, wurde konfiguriert und ist funktionsbereit.
  • Oder Was ist Crystal Reports für Visual Studio? wurde installiert und ist funktionsbereit.
NoteAnmerkung

Diese Prozedur funktioniert nur bei Projekten, die in Projekt-Setup erstellt wurden. Projekt-Setup enthält spezifische Namespaceverweise und Codekonfigurationen, die für diese Prozedur erforderlich sind. Die Prozedur kann ohne diese Konfiguration nicht ausgeführt werden. Führen Sie deshalb vor Beginn dieser Arbeitsschritte die Schritte unter Projekt-Setup aus.

  1. Deklarieren Sie innerhalb (der im Projekt-Setup erstellten) ConfigureCrystalReports()-Methode eine Instanz von ServerFileReport.
``` vb
Dim myServerFileReport As CrystalDecisions.Shared.ServerFileReport = _New CrystalDecisions.Shared.ServerFileReport()
```

``` csharp
CrystalDecisions.Shared.ServerFileReport serverFileReport = new CrystalDecisions.Shared.ServerFileReport();
```
  1. Setzen Sie die ObjectType-Eigenschaft von ServerFileReport auf REPORT.

    myServerFileReport.ObjectType = CrystalDecisions.[Shared].EnumServerFileType.REPORT
    
    serverFileReport.ObjectType = CrystalDecisions.Shared.EnumServerFileType.REPORT;
    
  2. Legen Sie für die ReportPath-Eigenschaft von ServerFileReport den Bericht und sein Unterverzeichnis fest.

    Informationen zu Musterberichten finden Sie unter Verzeichnis "Samples".

    myServerFileReport.ReportPath = "\General Business\World Sales
    Report.rpt"
    
    serverFileReport.ReportPath = "\\General Business\\World Sales
    Report.rpt";
    
  3. Legen Sie die WebServiceURL-Eigenschaft von ServerFileReport auf den Speicherort des Berichtswebdienstes fest.

    Wenn Sie Crystal Reports Developer installiert haben, ist dies das virtuelle Viewerverzeichnis für die installierte Crystal Reports-Version. Siehe Virtuelles Viewerverzeichnis. Wenn Sie Crystal Reports Developer nicht installiert haben, ist dies die URL zu dem Berichtswebdienst, den Sie unter Konfigurieren der Serverdateien in Visual Studio 2005 oder 2008 erstellt haben.

    NoteAnmerkung

    Im folgenden Code wird das virtuelle Viewerverzeichnis für Crystal Reports für Visual Studio 2005 konfiguriert.

    myServerFileReport.WebServiceUrl =
    "https://localhost/CrystalReportsWebServices2005/ServerFileReportService.asmx"
    
    serverFileReport.WebServiceUrl =
    "https://localhost/CrystalReportsWebServices2005/ServerFileReportService.asmx";
    
  4. Legen Sie für die ReportSource-Eigenschaft des CrystalReportViewer-Steuerelements die ServerFileReport-Instanz fest.

    myCrystalReportViewer.ReportSource = myServerFileReport
    
    crystalReportViewer.ReportSource = serverFileReport1;
    

Siehe auch