Kompilieren und Ausführen von Codebeispielen
Bei den Codebeispielen in der Library-Dokumentation des Berichtsserver-Webdienstes handelt es sich um einfache Anwendungen, die Berichtsserver-Webdienstvorgänge mit vielen der verfügbaren Webdienstmethoden ausführen. Die Ausgabe dieser Anwendungen erfolgt an der Konsole oder an der Eingabeaufforderung.
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. |
Die SQL Server-Beispiele werden während des Setups nicht automatisch installiert. Anweisungen zum Installieren der Beispiele finden Sie unter Installieren von Beispielen.
Verwenden des Microsoft .NET Framework SDK
Mit mehreren Tools im .NET Framework SDK können Sie Reporting Services-Codebeispiele kompilieren und ausführen. Das .NET Framework SDK ist kostenlos erhältlich. Weitere Informationen finden Sie unter Installieren des .NET Framework SDK.
So kompilieren Sie ein Codebeispiel und führen es aus
Erstellen Sie mithilfe des Tools WSDL eine Reporting Services-Proxyklasse in Microsoft Visual Basic .NET oder Microsoft Visual C#. Weitere Informationen zum Verwenden dieses Tools finden Sie unter Creating the Web Service Proxy.
Kompilieren Sie die Quellcodedatei der Proxyklasse mit den folgenden Befehlen in eine .NET Framework-Assembly:
Verwenden Sie für Visual Basic Vbc.exe zum Kompilieren der Proxyklasse und Erstellen einer DLL-Datei. Beispiel:
vbc /target:library ReportingService2005.vb /r:System.dll /r:System.Xml.dll /r:System.Web.Services.dll
Verwenden Sie für C# Csc.exe zum Kompilieren der Proxyklasse und Erstellen einer DLL-Datei. Beispiel:
csc /target:library ReportingService2005.cs /r:System.dll /r:System.Xml.dll /r:System.Web.Services.dll
Erstellen Sie mit einem Text-Editor eine leere Textdatei mit dem Namen sample und der Erweiterung VB (für Visual Basic-Beispielcode) oder .CS (für C#-Beispielcode).
Kopieren Sie das Codebeispiel, das Sie ausführen möchten, und fügen Sie es in die leere Datei ein. Speichern Sie die Datei.
Öffnen Sie eine Eingabeaufforderung: Klicken Sie im Menü Start auf Ausführen, geben Sie cmd in das Textfeld** ein, und klicken Sie dann auf OK.
Geben Sie an der Eingabeaufforderung einen der folgenden Befehle zum Kompilieren des Codebeispiels ein. Die Pfade zur Beispieldatei und zur Datei RSWebService.dll können von den Pfaden in den folgenden Beispielen abweichen.
Verwenden Sie für Visual Basic Vbc.exe und den folgenden Befehl zum Angeben der Proxyklasse und der erforderlichen Systembibliotheken, um die Anwendung auszuführen:
vbc sample.vb /r:ReportingService2005.dll /r:System.dll /r:System.Web.Services.dll /r:System.Xml.dll
Verwenden Sie Csc.exe für C# und den folgenden Befehl zum Angeben der Proxyklasse und der Systembibliotheken, die zum Ausführen der Anwendung erforderlich sind:
csc sample.cs /r:ReportingService2005.dll /r:System.dll /r:System.Web.Services.dll /r:System.Xml.dll
Der Compiler erstellt eine ausführbare Datei mit dem Namen Sample.exe. Zum Ausführen des kompilierten Beispiels geben Sie an der Eingabeaufforderung sample.exe an.
Verwenden von Visual Studio
Mit der Entwicklungsumgebung von Visual Studio können Sie Reporting Services-Codebeispiele erstellen und ausführen.
So kompilieren Sie ein Codebeispiel und führen es aus
Klicken Sie im Menü Datei auf Neues Projekt.
Klicken Sie im Dialogfeld Neues Projekt in der Liste Projekttypen auf Visual Basic-Projekte oder Visual C#-Projekte.
Klicken Sie im rechten Bereich auf Konsolenanwendung.
Geben Sie in das Feld Name einen Namen für das neue Projekt ein.
Wählen Sie im Feld Speicherort den gewünschten Speicherort für die Datei aus.
Fügen Sie Ihrer Anwendung einen Webverweis hinzu. Weitere Informationen zum Hinzufügen von Webverweisen im Berichtsserver-Webdienst in Visual Studio .NET finden Sie unter Creating the Web Service Proxy.
Benennen Sie die Projektdatei Class1.cs in Sample.cs um. Für Visual Basic benennen Sie Module1.vb in Sample.vb um.
Kopieren Sie das gewünschte Codebeispiel, und fügen Sie es in der Beispielcodedatei an der dafür vorgesehenen Stelle ein. Speichern Sie die Datei.
Starten Sie die Anwendung: Drücken Sie F5, oder klicken Sie im Menü Debuggen auf Starten.
Verwenden des rs-Dienstprogramms
Reporting Service stellt das Skripterstellungsprogramm rs bereit. Es ist im Lieferumfang als Datei rs.exe enthalten. Sie können jedes Visual Basic-Codebeispiel, das in der Library-Dokumentation des Berichtsserver-Webdiensts verfügbar ist, mit dem rs-Dienstprogramm ausführen, das von Reporting Services bereitgestellt wird.
So führen Sie ein Codebeispiel aus
Erstellen Sie mit einem Text-Editor die leere Textdatei sample.rss.
Kopieren Sie den folgenden Code, und fügen Sie ihn in die leere Datei ein:
Public Sub Main() ' Your code goes here. End Sub
Kopieren Sie das gewünschte Codebeispiel, und fügen Sie es im vorherigen Codebeispiel an der dafür vorgesehenen Stelle ein. Speichern Sie die Datei. Wenn Sie direkt aus einem Codebeispiel in einem Referenzthema kopieren, entfernen Sie etwaige Importanweisungen, Moduldeklarationen und die folgende Codezeile:
Dim rs As New ReportingService2005()
Das Objekt ReportingService2005 ist bereits deklariert und in der Skriptumgebung instanziiert. Durch das erneute Deklarieren des Objekts in Ihrem Code schlägt das Skript fehl. Weitere Informationen zu richtig geschriebenen Skripts finden Sie unter Formatting the Reporting Services Script File.
Öffnen Sie eine Eingabeaufforderung: Klicken Sie im Menü Start auf Ausführen, geben Sie cmd in das Textfeld ein, und klicken Sie auf OK.
Navigieren Sie zum Verzeichnis, das die Datei Sample.rss enthält. Geben Sie an der Eingabeaufforderung den folgenden Befehl zum Ausführen der Beispielskriptdatei ein. Ersetzen Sie den angegebenen Server-URL unbedingt durch den Server-URL des Berichtsservers und Endpunktes, auf die Sie zugreifen. Beispiel:
rs –i sample.rss –s http://myserver/reportserver
Hinweis: Wenn in einer Meldung angezeigt wird, dass rs nicht erkannt wird, müssen Sie möglicherweise der Windows-Umgebungsvariablen PATH den Pfad für rs.exe hinzufügen.
Siehe auch
Aufgaben
Beispiele für SQL Server Reporting Services
Andere Ressourcen
Creating the Web Service Proxy
Web Service Authentication