So debuggen Sie benutzerdefinierte Assemblys

Microsoft .NET Framework stellt mehrere hilfreiche Tools zum Debuggen zur Verfügung, die Sie bei der Analyse Ihres benutzerdefinierten Assemblycodes und bei der Fehlersuche unterstützen. Das beste Zu verwendende Tool hängt davon ab, was Sie erreichen möchten. In diesem Beispiel wird Visual Studio verwendet.

Am besten können Sie benutzerdefinierte Assemblys für Reporting Services entwerfen, entwickeln und testen, wenn Sie eine Projektmappe erstellen, die sowohl Ihre Testberichte als auch Ihre benutzerdefinierte Assembly enthält.

Debuggen von Assemblys mithilfe einer einzelnen Instanz von Visual Studio

1. Erstellen Sie ein neues Berichtsprojekt mit Visual Studio.

   Wenn Sie ein Berichtsprojekt erstellen, erstellt Visual Studio auch eine Lösung, die es enthalten soll.

2. Fügen Sie der vorhandenen Projektmappe ein neues Klassenbibliotheksprojekt hinzu. Stellen Sie sicher, dass das Berichtsprojekt als Startprojekt festgelegt wird. Weitere Informationen hierzu finden Sie in der Visual Studio-Dokumentation.

3. Wählen Sie die Projektmappe im Projektmappen-Explorer aus.

4. Wählen Sie im Menü "Ansicht " die Option "Eigenschaftenseiten" aus.

   Das Dialogfeld Eigenschaftenseiten der Projektmappe wird geöffnet.

5. Erweitern Sie im linken Bereich bei Bedarf allgemeine Eigenschaften , und wählen Sie "Projektabhängigkeiten" aus. Wählen Sie das Berichtsprojekt aus der Dropdownliste Projekt aus. Wählen Sie das Assemblyprojekt in der Liste der Abhängigkeiten aus.

6. Wählen Sie "OK" aus, um die Änderungen zu speichern, und schließen Sie das Dialogfeld "Eigenschaftenseiten".

7. Wählen Sie im Projektmappen-Explorer Ihr benutzerdefiniertes Assemblyprojekt aus.

8. Wählen Sie im Menü "Ansicht " die Option "Eigenschaftenseiten" aus.

   Das Dialogfeld der Eigenschaftenseite des Projekts wird geöffnet.

9. Wählen Sie die Registerkarte "Erstellen " aus, wenn Sie sich in einem C#-Projekt oder auf der Registerkarte "Kompilieren " befinden, wenn Sie sich in einem Visual Basic-Projekt befinden.

10. Geben Sie auf der Seite Erstellen/Kompilieren den Pfad zum Ordner des Berichts-Designers ein. Der Standardpfad lautet "C:\Programme\Microsoft SQL Server\100\Tools\Binn\VSShell\Common7\IDE) im Textfeld "Ausgabepfad ". Damit wird eine aktualisierte Version der benutzerdefinierten Assembly erstellt und direkt im Berichts-Designer bereitgestellt, bevor der Bericht ausgeführt wird.

11. Nachdem Sie Ihren Bericht entwerfen und Ihre benutzerdefinierte Assembly entwickelt haben, legen Sie Haltepunkte in Ihrem benutzerdefinierten Assemblycode fest.

12. Führen Sie den Bericht unter dem DebugLocal-Modus aus, indem Sie die F5-TASTE drücken. Wenn der Bericht in der Popup-Vorschau ausgeführt wird, sucht der Debugger alle Breakpoints, die dem ausführbaren Code in Ihrer Assembly entsprechen. Verwenden Sie F11, um den Code der benutzerdefinierten Assembly schrittweise zu durchlaufen.

So debuggen Sie Assemblys mithilfe von zwei Instanzen in Visual Studio

1. Starten Sie Visual Studio, und öffnen Sie das Projekt Ihrer benutzerdefinierten Assembly.

2. Erstellen Sie das Projekt, und stellen Sie die benutzerdefinierte Assembly und die dazugehörige PDB-Datei im Berichts-Designer bereit. Weitere Informationen zur Bereitstellung finden Sie unter Deploying a Custom Assembly (Bereitstellen einer benutzerdefinierten Assembly).

3. Öffnen Sie ein Berichtsprojekt, das Ihre benutzerdefinierte Assembly verwendet, und lassen Sie dabei den Code der benutzerdefinierten Assembly in einer anderen Instanz von Visual Studio geöffnet.

4. Wechseln Sie zu der Visual Studio-Instanz mit dem Projekt für die benutzerdefinierte Assembly, und legen Sie einige Breakpoints im Code fest.

5. Wenn das benutzerdefinierte Assemblyprojekt weiterhin das aktive Fenster ist, wählen Sie im Menü "Debuggen" die Option "An Prozess anfügen" aus.

   Das Dialogfeld An den Prozess anhängen wird geöffnet.

6. Wählen Sie in der Liste der Prozesse den Devenv.exe-Prozess aus, der Ihrem Berichtsprojekt entspricht, und wählen Sie "Anfügen" aus.

7. Definieren Sie die Ausdrücke, die Sie in Ihrem Bericht aus der benutzerdefinierten Assembly verwenden und den Bericht entwerfen.

8. Wenn Sie mit dem Entwerfen des Berichts fertig sind, wählen Sie die Registerkarte "Vorschau " aus.

   Der Bericht wird ausgeführt, und der Code der benutzerdefinierten Assembly sollte an den vordefinierten Breakpoints unterbrochen werden.

   Hinweis

   Bei Verwendung der Registerkarte Vorschau werden keine Codeberechtigungen für die Assembly erzwungen. Sie können einen vollständigen Test, der alle Fehler der Codezugriffssicherheit enthält, durchführen, indem Sie das Berichtsprojekt unter der Konfigurationseinstellung DebugLocal starten.

9. Gehen Sie den Code schrittweise mit der F11-Taste durch. Weitere Informationen zum Debuggen mit Visual Studio finden Sie in der Dokumentation zu Visual Studio.

Zugehöriger Inhalt

Verwenden benutzerdefinierter Assemblys mit Berichten