Procédure : déboguer des assemblys personnalisés
Le Microsoft .NET Framework propose différents outils de débogage qui peuvent vous aider à analyser le code de votre assembly personnalisé et à trouver les éventuelles erreurs qu'il contient. Vous devez choisir un outil en fonction de ce que vous essayez d'accomplir. Cet exemple utilise Visual Studio 2008.
La méthode recommandée pour concevoir, développer et tester des assemblys personnalisés pour Reporting Services consiste à créer une solution contenant à la fois vos rapports de test et votre assembly personnalisé.
Pour déboguer des assemblys à l'aide d'une instance unique de Visual Studio
Créez un projet de rapport à l'aide de Visual Studio.
En même temps que vous créez un projet de rapport, Visual Studio crée une solution destinée à le contenir.
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 procédure à suivre, consultez la documentation de Visual Studio.
Dans l'Explorateur de solutions, sélectionnez la solution de votre choix.
Dans le menu Affichage, cliquez sur Pages de propriétés.
La boîte de dialogue Pages de propriétés de Solution s'affiche.
Dans le volet gauche, développez Propriétés communes si nécessaire, et cliquez sur 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.
Cliquez sur OK pour enregistrer les modifications et fermez le dialogue Pages de propriétés.
Dans l'Explorateur de solutions, sélectionnez votre projet d'assembly personnalisé.
Dans le menu Affichage, cliquez sur Pages de propriétés.
La boîte de dialogue Pages de propriétés de Projet s'affiche.
Cliquez sur l'onglet Version si vous travaillez sur un projet C# ou sur l'onglet Compiler s'il s'agit d'un projet Visual Basic.
Sur la page Générer/Compiler, entrez le chemin d'accès au dossier Concepteur de rapports. Par défaut, il s'agit de 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.
Une fois votre rapport généré et votre assembly personnalisé développé, définissez des points d'arrêt dans le code de votre assembly personnalisé.
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
Démarrez Visual Studio et ouvrez votre projet d'assembly personnalisé.
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é.
Ouvrez un projet de rapport utilisant votre assembly personnalisé en laissant votre code d'assembly personnalisé ouvert dans une instance distincte de Visual Studio.
Naviguez vers l'instance de Visual Studio qui contient votre projet d'assembly personnalisé et définissez des points d'arrêt dans votre code.
Alors que le projet d'assembly personnalisé se trouve toujours dans la fenêtre active, cliquez sur Attacher au processus dans le menu Déboguer.
La boîte de dialogue Attacher au processus s'ouvre.
Dans la liste des processus, sélectionnez le processus devenv.exe qui correspond à votre projet de rapport, puis cliquez sur Attacher.
Définissez les expressions qui vous utiliserez dans votre rapport à partir de votre assembly personnalisé et concevez votre rapport.
Une fois la conception de votre rapport terminée, cliquez sur 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.
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.