• Artikel

Vorgehensweise: Debuggen von benutzerdefinierten Assemblys

Microsoft.NET Framework stellt mehrere hilfreiche Tools zum Debuggen zur Verfügung, die Sie bei der Analyse des Codes in benutzerdefinierten Assemblys und bei der Fehlersuche im Code unterstützen. Welches Tool dafür am besten geeignet ist, hängt von Ihrer Zielsetzung ab. In diesem Beispiel wird Microsoft Visual Studio 2005 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.

So debuggen Sie Assemblys mithilfe einer Instanz von Visual Studio

  1. So legen Sie ein neues Berichtsmodellprojekt mithilfe von Visual Studio an.

    Während Sie ein Berichtsprojekt erstellen, wird von Visual Studio auch eine Projektmappe für das Projekt angelegt.

  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 Ihrer Visual Studio 2005-Dokumentation.

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

  4. Klicken Sie im Menü Ansicht auf die Option Eigenschaftenseiten.

    Das Dialogfeld Eigenschaftenseiten des Projekts wird geöffnet.

  5. Wenn nötig, öffnen Sie im linken Bereich Allgemeine Eigenschaften, und klicken Sie auf Projektabhängigkeiten. Wählen Sie das Berichtsprojekt aus der Dropdownliste Projekt aus. Wählen Sie das Assemblyprojekt in der Liste der Abhängigkeiten aus.

  6. Klicken Sie auf OK, um die Änderungen zu speichern, und schließen Sie das Dialogfeld Eigenschaftenseiten.

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

  8. Klicken Sie im Menü Ansicht auf die Option Eigenschaftenseiten.

    Das Dialogfeld Eigenschaftenseiten des Projekts wird geöffnet.

  9. Im linken Bereich öffnen Sie die Konfigurationseigenschaften und klicken auf Erstellen, wenn Sie sich in einem C#-Projekt befinden, oder klicken Sie auf Kompilieren, 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. Standardmäßig ist dies 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. Wenn Sie den Bericht entworfen und die benutzerdefinierte Assembly entwickelt haben, legen Sie die Breakpoints im Code der benutzerdefinierten Assembly 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 2005, und öffnen Sie das Projekt der 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 Bereitstellen einer benutzerdefinierten Assembly.

  3. Öffnen Sie ein Berichtsprojekt, das Ihre benutzerdefinierte Assembly verwendet, ohne den Code der benutzerdefinierten Assembly in einer anderen Instanz von Visual Studio zu schließen.

  4. Wechseln Sie zur Visual Studio-Instanz, die das Projekt für die benutzerdefinierte Assembly enthält, und legen Sie einige Breakpoints im Code fest.

  5. Während das Projekt der benutzerdefinierten Assembly noch immer das aktive Fenster ist, klicken Sie im Menü Debuggen auf Verarbeiten.

    Das Dialogfeld Prozesse wird geöffnet.

  6. Wählen Sie aus der Liste der Prozesse den Prozess devenv.exe aus, der dem Berichtsprojekt entspricht, und klicken Sie auf Anfügen. Wenn das Dialogfeld An den Prozess anhängen geöffnet wird, vergewissern Sie sich, dass der Programmtyp Common Language Runtime ausgewählt ist, und klicken Sie dann auf OK.

  7. Definieren Sie die Ausdrücke, die Sie im Bericht verwenden möchten, aus der benutzerdefinierten Assembly, und entwerfen Sie Ihren Bericht.

  8. Wenn Sie den Bericht entworfen haben, klicken Sie auf die Registerkarte Vorschau.

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

    HinweisHinweis

    Bei Verwendung der Registerkarte Vorschau werden keine Codeberechtigungen für die Assembly durchgesetzt. Einen vollständigen Test, der alle Fehler der Codezugriffssicherheit enthält, können Sie 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.