FindRenderSave-Beispielanwendung für Windows

Artikel
12/15/2008

Aktualisiert: 05. Dezember 2005

FindRenderSave ist eine Beispielanwendung für Microsoft Windows, die mit Microsoft Visual Studio entwickelt wurde. Diese Anwendung basiert auf einem tatsächlichen Szenario und veranschaulicht die Entwicklung einer Windows-Anwendung, die den Berichtsserver-Webdienst verwendet. Dieses Beispiel ermöglicht mit der SOAP-API das Suchen nach Berichten in der Berichtsserver-Datenbank, das Prüfen der Berichtseigenschaften und das Rendern der Berichte in verschiedenen Datenträgerformaten. 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:
Beispielanwendungen sollten nicht ohne die Zustimmung des Systemadministrators mit der SQL Server-Datenbank oder dem Berichtsserver verbunden sein oder mit diesen verwendet werden.

Anforderungen

Damit Sie das FindRenderSave-Beispiel verwenden können, sollten Sie mit Microsoft Visual Studio und entweder mit Microsoft Visual C# oder Microsoft Visual Basic vertraut sein. Außerdem muss Ihr System die folgenden Anforderungen erfüllen:

Visual Studio 2005 oder eine kompatible Entwicklungsumgebung (zum Anzeigen der Projektdateien)
Microsoft .NET Framework, Version 2.0
Reporting Services-Beispiele. Sie haben die Möglichkeit, die Beispiele beim Ausführen des SQL Server 2005-Setups zu installieren. In dieser Version wird durch die Installation der Beispiele 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.
Einen 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. Das Beispiel geht davon aus, dass SQL Server 2005 Reporting Services auf dem Entwicklungscomputer installiert ist.

Speicherort

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

Beispiel:

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Application Samples\FindRenderSave 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 FindRenderSave-Beispiel in Visual Studio und führen es dort aus

Öffnen Sie die Projektmappe (FindRenderSaveCS.sln oder FindRenderSaveVB.sln).
Klicken Sie im Menü Debuggen auf Starten ohne Debuggen.
Klicken Sie auf Schließen, um die Anwendung zu beenden.

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

Wechseln Sie mit dem Befehl CD (Change Directory) in das Verzeichnis \FindRenderSave.
Geben Sie Folgendes ein, um sowohl die C#- als auch die Visual Basic-Version des Beispiels zu erstellen:
```
for /r %f in (*.sln) do C:\WINDOWS\Microsoft.NET\Framework\v2.0.40607\msbuild.exe "%f"
```
Hinweis:

Der Windows-Systempfad und die .NET Framework-Versionsnummer lauten auf Ihrem System möglicherweise anders.
Doppelklicken Sie im Verzeichnis \Bin\Debug der Anwendung auf FindRenderSave.exe, um die Anwendung zu starten.
Klicken Sie auf Schließen, um die Anwendung zu schließen.

Hinweis:
Der Windows-Systempfad und die .NET Framework-Versionsnummer lauten auf Ihrem System möglicherweise anders.

Verwenden von FindRenderSave

Nach der Installation der FindRenderSave-Beispielanwendung können Sie damit nach Berichten suchen, Berichtseigenschaften anzeigen und Berichte in verschiedenen Datenträgerformaten rendern. Standardmäßig versucht die Anwendung, eine Verbindung zu einer Instanz des Berichtsserver-Webdienstes herzustellen, die sich auf demselben Computer befindet, auf dem FindRenderSave 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 FindRenderSave-Beispielanwendung

Öffnen Sie FindRenderSave.sln in Visual Studio.
Klicken Sie im Menü Debuggen auf Starten, um die Beispielanwendung auszuführen.
Suchen Sie mithilfe der Liste Suchen nach anhand des Namens und/oder der Beschreibung nach Berichten.
Geben Sie den gewünschten Text für die Suche in das Feld für die Suchzeichenfolge ein. Klicken Sie auf Suchen, wenn Sie die Suchzeichenfolge eingegeben haben.

Eine Liste der Berichte, die den Suchkriterien entsprechen, wird in der Liste mit den gefundenen Elementen angezeigt.
Klicken Sie in der Liste mit den gefundenen Elementen**** auf einen Bericht, um die Beschreibung und die Pfadeigenschaften anzuzeigen.
Wenn ein Bericht ausgewählt ist, können Sie den Bericht in einem von vier Renderformaten rendern: Excel, Image, Web archive (MHTML) oder PDF. Zum Auswählen eines Renderformats verwenden Sie die Liste Rendern als.

Klicken Sie auf Bericht speichern, um den Bericht zu speichern.

Das Dialogfeld Speichern unter wird geöffnet.

Hinweis:
Berichte, die Anmeldeinformationen erfordern, oder parametrisierte Berichte, bei denen nicht für alle Parameter Standardwerte angegeben wurden, werden von FindRenderSave nicht gerendert oder gespeichert.

Wählen Sie einen Speicherort aus, geben Sie einen Namen für den Bericht ein, und klicken Sie dann auf Speichern.
Klicken Sie auf Schließen, 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