Binden an Report Application Server (Crystal Reports 10 und höher)

Anmerkung
Auf dieser Seite werden Funktionen beschrieben, die nicht in Crystal Reports für Visual Studio, jedoch in einer der aktualisierten Versionen verfügbar sind. Weitere Informationen zu Crystal Reports für Visual Studio finden Sie unter Was ist Crystal Reports für Visual Studio? Weitere Informationen zu aktualisierten Versionen finden Sie unter Aktualisierungsoptionen.

Objektmodell

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

Ort des Berichts

Berichte befinden sich auf dem unverwalteten RAS-Server (siehe Report Application Server (RAS)). Der Bericht ist in der ReportDocument-Klasse eingeschlossen.

Übersicht über Crystal Services

Dieses Berichtbindungsszenario bezieht sich auf Berichte, auf die über den Serverknoten "Crystal Services" im Server-Explorer zugegriffen wird.

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

In diesem Abschnitt wird der Unterknoten "Report Application Server" des Knotens "Crystal Services" in Crystal Reports Developer behandelt.

[SERVERNAME]

Crystal Services
- Report Application Server

Beschreibung

Über den Unterknoten "Report Application Server" greifen Sie auf Berichte zu, die von einem unverwalteten RAS-Server verfügbar gemacht wurden, und lassen sie anzeigen. Der RAS-Knoten kann nur ausgewählt werden, wenn der unverwaltete RAS auf dem Zielcomputer installiert wurde.

Wenn Sie einen Bericht vom Knoten "Crystal Services">"Crystal Enterprise" ziehen und auf einem Web Form oder Windows Form ablegen, wird eine Instanz von ReportDocument generiert. Die ReportDocument-Klasse funktioniert als Wrapperklasse Ihre Aufgabe ist es, den vom unverwalteten RAS-Server übergebenen Bericht einzuschließen (darzustellen).

Eine Vergleichstabelle zu "Crystal Services" finden Sie unter einem der folgenden Themen:

Pro

Unkomplizierter Zugriff: Berichte vom unverwalteten RAS-Server können problemlos in einer Strukturansicht angezeigt und auf ein Web Form gezogen werden.
Umfangreiche programmatische Interaktion: Bietet Zugriff auf das leistungsfähige ReportDocument-Objektmodell. Die Wrapperklasse des Berichts in dieser Version ist ReportDocument. Dies ist die erste Version von Crystal Services, die Ihnen Zugriff auf das ReportDocument-Objektmodell gewährt.

Contra

Indirektere Codierung: Die Codierung ist nicht so direkt wie die Codierung von RAS-Berichten mit dem ReportClientDocument-Objektmodell. Siehe Binden an unverwalteten RAS-Server mit der ReportClientDocument.Open()-Methode.

So verwenden Sie "Crystal Services" > "Report Application Server"

Crystal Reports 10 oder höher wurde installiert und ist funktionsbereit.
Der unverwaltete RAS-Server wurde installiert und ist funktionsbereit.

Anmerkung
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.

Öffnen Sie in Visual Studio Server-Explorer.
Erweitern Sie erst Crystal Services und dann Report Application Server.
Wählen Sie einen Bericht aus der Struktur Report Application Server, und ziehen Sie ihn auf das Web Form oder Windows Form.

Im unteren Bereich des Formulars in der Entwurfsansicht wird ein reportDocument1-Objekt angezeigt.

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images\xkh1wxd8.alert_note(de-de,VS.90).gif" alt="Note" class="note" />Anmerkung</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>Wenn ein Report Application Server-Bericht in das Formular eingefügt wird, wird dem Bereich &quot;Vom Designer generierter Code&quot; des Formulars eine Instanz der ReportDocument-Klasse hinzugefügt.</p></td>
</tr>
</tbody>
</table>

Wenn Klassen, die von System.ComponentModel.Component erben (wie ReportDocument), innerhalb des Bereichs "Vom Designer generierter Code" instantiiert und konfiguriert werden, wird im unteren Bereich des Formulars in der Entwurfsansicht ein Symbol dieser instantiierten Klasse angezeigt.

Wechseln Sie zur Codeansicht, und öffnen Sie den Bereich Vom Web/Windows Form Designer generierter Code.

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images\xkh1wxd8.alert_note(de-de,VS.90).gif" alt="Note" class="note" />Anmerkung</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>Innerhalb dieses Bereichs wurde eine ReportDocument-Klasse instantiiert und konfiguriert.</p></td>
</tr>
</tbody>
</table>

Weisen Sie der ReportSource-Eigenschaft des CrystalReportViewer-Steuerelements innerhalb der (im Projekt-Setup erstellten) ConfigureCrystalReports()-Methode die ReportDocument-Instanz zu.

``` vb
myCrystalReportViewer.ReportSource = reportDocument1
```

``` csharp
crystalReportViewer.ReportSource = reportDocument1;
```

Um den Bericht anzeigen zu lassen, erstellen Sie Ihr Projekt und führen es aus.

Siehe auch

Last updated on 2008-04-22