Guide pratique pour déboguer des assemblys personnalisés

Microsoft .NET Framework fournit plusieurs outils de débogage qui peuvent vous aider à analyser votre code d’assembly personnalisé et à localiser les erreurs qu’il contient. Le meilleur outil à utiliser dépend de ce que vous essayez d’accomplir. Cet exemple utilise Visual Studio 2008.

La méthode recommandée si vous souhaitez concevoir, développer et tester des assemblys personnalisés pour Reporting Services consiste à créer une solution qui contient à la fois vos rapports de test et votre assembly personnalisé.

Déboguer des assemblys à l’aide d’une instance unique de Visual Studio

1. Créez un projet de rapport à l’aide de Visual Studio.

   Lorsque vous créez un projet de rapport, Visual Studio crée également une solution pour la contenir.

2. Ajoutez un nouveau projet Bibliothèque de classes à la solution existante. Assurez-vous que le projet de rapport est défini comme projet de démarrage. Pour plus d’informations sur la façon d’y parvenir, consultez la documentation de Visual Studio.

3. Dans l'Explorateur de solutions, sélectionnez la solution de votre choix.

4. Dans le menu Affichage , sélectionnez Pages de propriétés.

   La boîte de dialogue Pages de propriétés de Solution s’affiche.

5. Dans le volet gauche, développez Propriétés communes si nécessaire, puis sélectionnez Dépendances du projet. Sélectionnez le projet de rapport dans la liste déroulante Projet. Sélectionnez votre projet d’assembly dans la liste Dépend de.

6. Sélectionnez OK pour enregistrer les modifications, puis fermez la boîte de dialogue Pages de propriétés.

7. Dans l'Explorateur de solutions, sélectionnez votre projet d'assembly personnalisé.

8. Dans le menu Affichage , sélectionnez Pages de propriétés.

   La boîte de dialogue Pages de propriétés de Projet s’affiche.

9. Sélectionnez l’onglet Générer si vous êtes dans un projet C# ou dans l’onglet Compiler si vous êtes dans un projet Visual Basic.

10. Dans la page Générer/Compiler, entrez le chemin du dossier Concepteur de rapports. Le chemin par défaut est C :\Program Files\Microsoft SQL Server\100\Tools\Binn\VSShell\Common7\IDE) dans la zone de texte Chemin de sortie. Une version mise à jour de votre assembly personnalisé est alors générée et déployée directement dans le Concepteur de rapports avant exécution de votre rapport.

11. Une fois que vous avez conçu votre rapport et développé votre assembly personnalisé, définissez des points d’arrêt dans votre code d’assembly personnalisé.

12. Exécutez le rapport en mode DebugLocal en appuyant sur la touche F5. Lorsque le rapport s'exécute dans la fenêtre d'aperçu contextuelle, le débogueur atteint chacun des points d'arrêt correspondant au code exécutable de votre assembly. Utilisez la touche F11 pour exécuter le code de votre assembly personnalisé en pas à pas.

Pour déboguer des assemblys à l'aide de deux instances de Visual Studio

1. Démarrez Visual Studio, et ouvrez votre projet d’assembly personnalisé.

2. Générez le projet et déployez votre assembly personnalisé de même que le fichier .pdb associé dans le Concepteur de rapports. Pour plus d’informations sur le déploiement, consultez Déploiement d’un assembly personnalisé.

3. Ouvrez un projet de rapport qui utilise votre assembly personnalisé tout en laissant votre code d’assembly personnalisé ouvert dans une instance distincte de Visual Studio.

4. Accédez à l’instance de Visual Studio qui contient votre projet d’assembly personnalisé, puis définissez des points d’arrêt dans votre code.

5. Avec le projet d’assembly personnalisé toujours la fenêtre active, sélectionnez Attacher au processus dans le menu Débogage .

   La boîte de dialogue Attacher au processus s’ouvre.

6. Dans la liste des processus, sélectionnez le processus devenv.exe qui correspond à votre projet de rapport, puis sélectionnez Attacher.

7. Définissez les expressions que vous utiliserez dans votre rapport à partir de votre assembly personnalisé et concevez votre rapport.

8. Lorsque vous avez terminé de concevoir votre rapport, sélectionnez l’onglet Aperçu .

   Le rapport s'exécute et le code de l'assembly personnalisé doit s'arrêter aux points d'arrêt prédéfinis.

   Notes

   L’utilisation de l’onglet Aperçu ne permet pas d’appliquer les autorisations de code de l’assembly. Pour effectuer un test complet, qui inclut toutes les erreurs de sécurité d’accès du code, lancez le projet de rapport avec le paramètre de configuration DebugLocal.

9. Exécutez le code pas à pas à l'aide de la touche F11. Pour plus d’informations sur le débogage à l’aide de Visual Studio, consultez la documentation de Visual Studio.

Contenu connexe

Utilisation d'assemblages personnalisés avec des rapports