AsynchronousRender-Beispielanwendung für Windows

Artikel
12/15/2008

Aktualisiert: 05. Dezember 2005

AsynchronousRender ist eine Windows-Beispielanwendung, die mithilfe von Visual Studio 2005 entwickelt wurde. Die Anwendung basiert auf einem Szenario aus der Praxis und zeigt, wie Sie eine Windows-Anwendung entwickeln können, die den Berichtsserver-Webdienst verwendet. Das Beispiel ermöglicht es Ihnen, über eine SOAP-API (Simple Object Access-Protokoll) den Inhalt eines lokalen Berichtsservers anzuzeigen, einen Bericht auszuwählen und den Bericht anschließend mithilfe der asynchronen Serverkommunikation auf den Datenträger zu rendern. Dieses Beispiel wird nicht auf Itanium-basierten Betriebssystemen unterstützt.

Die SQL Server-Beispiele werden während des Setups nicht automatisch installiert. Anweisungen zum Installieren der Beispiele finden Sie unter Installieren von Beispielen.

Wichtig:
Diese Beispiele dienen nur zu Lernzwecken. Sie sind nicht für die Verwendung in einer Produktionsumgebung gedacht und wurden nicht in einer Produktionsumgebung getestet. Microsoft bietet für diese Beispiele keinen technischen Support.

Anforderungen

Sie sollten mit Visual Studio und mindestens einer der .NET Framework-Programmiersprachen vertraut sein. Außerdem sollten die folgenden Komponenten installiert sein, damit Sie das AsynchronousRender-Beispiel verwenden können:

Microsoft Visual Studio 2005 oder eine kompatible Entwicklungsumgebung (zum Anzeigen der Projektdateien)
Microsoft .NET Framework, Version 2.0
SQL Server 2005, einschließlich Reporting Services
Reporting Services-Beispiele. Sie können die Beispiele beim Ausführen des SQL Server 2005-Setups installieren. Wenn Sie sich in dieser Version für die Installation der Beispiele entscheiden, wird ein separates Installationsprogramm auf Ihrem Computer installiert, mit dessen Hilfe Sie Beispiele extrahieren und installieren können. Sie können dieses Installationsprogramm über das Menü Start in der Programmgruppe Microsoft SQL Server 2005 ausführen.
Ein Berichtsserver, für den Sie in Ihrem Netzwerk die Zugriffsberechtigung haben, falls Sie mit der Beispielclientanwendung den Inhalt eines Berichtsservers anzeigen und Berichte rendern möchten.

Speicherort

Dieses Beispiel befindet sich im Unterverzeichnis Application Samples\AsynchronousRender Sample des Verzeichnisses mit den Reporting Services-Beispielen.

Beispiel:

C:\Program Files\Microsoft SQL Server\90\Samples

\Reporting Services\Application Samples\AsynchronousRender Sample

Erstellen des Beispiels

Generieren Sie die Schlüsseldatei mithilfe der folgenden Anweisungen, falls Sie noch keine Schlüsseldatei mit starkem Namen erstellt haben.

So generieren Sie eine Schlüsseldatei mit starkem Namen

Öffnen Sie eine Microsoft Visual Studio 2005-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und danach auf Microsoft .NET Framework SDK 2.0, und klicken Sie anschließend auf SDK-Eingabeaufforderung.

– oder –

Öffnen Sie eine Microsoft .NET Framework-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und dann auf Microsoft .NET Framework SDK 2.0, und klicken Sie anschließend auf SDK-Eingabeaufforderung.

Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Verzeichnis wechseln) im Eingabeaufforderungsfenster vom aktuellen Verzeichnis zu dem Ordner, in dem die Beispiele installiert sind.

Hinweis:
Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft SQL Server und auf Dokumentation und Lernprogramme, und klicken Sie dann auf Beispielordner, um den Ordner zu ermitteln, in dem sich die Beispiele befinden. Wenn das Standardverzeichnis verwendet wurde, befinden sich die Beispiele im Verzeichnis <Systemlaufwerk>:\Programme\Microsoft SQL Server\100\Samples.

Führen Sie an der Eingabeaufforderung den folgenden Befehl zum Generieren der Schlüsseldatei aus:

sn -k SampleKey.snk

Wichtig:
Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Starke Namen und Sicherheit im .NET Framework" unter ".NET-Entwicklung" auf der MSDN-Website.

So erstellen Sie das AsynchronousRender-Beispiel in Visual Studio und führen es dort aus

Öffnen Sie die Projektmappe (AsynchronousRenderCS.sln oder AsynchronousRenderVB.sln).
Klicken Sie im Menü Debuggen auf Starten ohne Debuggen.
Klicken Sie auf Beenden, um die Anwendung zu beenden.

So erstellen Sie das AsynchronousRender-Beispiel in der Befehlszeile und führen es dort aus

Wechseln Sie mithilfe des Befehls cd (Verzeichnis wechseln) in das AsynchronousRender-Verzeichnis.
Geben Sie Folgendes ein, um sowohl die C#- als auch die Visual Basic-Version des Beispiels zu erstellen, und ändern Sie dabei entsprechend den .NET Framework-Pfad. Beispiel:
```
for /r %f in (*.sln) do C:\WINDOWS\Microsoft.NET\Framework\v2.0.40607\msbuild.exe "%f"
```
Doppelklicken Sie im Verzeichnis \Bin\Debug der Anwendung auf AsynchronousRender.exe, um die Anwendung zu starten.
Klicken Sie auf Beenden, um die Anwendung zu beenden.

Verwenden des Beispiels

Nach dem Erstellen und Ausführen der AsynchronousRender-Beispielanwendung können Sie das Beispiel zum Suchen nach und Rendern von Berichten in Ihrer Berichtsserver-Datenbank verwenden. Standardmäßig versucht die Anwendung, eine Verbindung zu einer Instanz des Berichtsserver-Webdienstes herzustellen, die sich auf demselben Computer befindet, auf dem AsynchronousRender ausgeführt wird.

Wichtig:
Beispielanwendungen sollten nicht ohne die Zustimmung des Systemadministrators mit der SQL Server-Datenbank oder dem Berichtsserver verbunden sein oder mit diesen verwendet werden.

So verwenden Sie die AsynchronousRender-Beispielanwendung

Stellen Sie mithilfe der Schaltfläche Verbinden eine Verbindung zum lokalen Berichtsserver her, und rufen Sie eine Liste mit Elementen im Namespace des Berichtsservers ab.
Wählen Sie mithilfe des TreeView-Steuerelements einen Bericht aus.
Wenn Sie einen Bericht ausgewählt haben, können Sie diesen asynchron in das Webarchiv (MHTML) rendern. Um den Bericht zu rendern, klicken Sie auf Rendern.

Während die Anwendung auf eine Antwort vom Server wartet, wird ein Ausführungszeitgeber ausgeführt. Ein Meldungsfeld wird angezeigt, sobald der Bericht gerendert und abrufbereit ist. Um den Bericht auf den Datenträger zu speichern, klicken Sie auf Ja.
Wählen Sie einen Speicherort aus, geben Sie einen Namen für den Bericht ein, und klicken Sie dann auf Speichern.
Klicken Sie auf Beenden, um die Anwendung zu beenden.

Siehe auch

Änderungsverlauf

Version	Verlauf
05. Dezember 2005	Geänderter Inhalt: Die Anweisungen zum Generieren einer Schlüsseldatei wurden geändert, einschließlich des Namens und Speicherortes der Schlüsseldatei.

Freigeben über