Partager via


Débogueur CLR (DbgCLR.exe)

Le débogueur Microsoft CLR (DbgCLR.exe) fournit des services de débogage dotés d'une interface graphique qui permettent aux développeurs d'applications de rechercher et de réparer les bogues dans les programmes ciblant le Common Language Runtime. Le débogueur CLR et sa documentation s'appuient sur le travail effectué pour le débogueur Microsoft Visual Studio 2005. Par conséquent, la documentation fait surtout référence au débogueur Visual Studio plutôt qu'au débogueur CLR. Dans la plupart des cas, les informations s'appliquent aux deux débogueurs. Vous pouvez toutefois trouver des sections de la documentation qui décrivent des caractéristiques non implémentées dans le débogueur CLR (voir le paragraphe suivant). Ignorez simplement ces fonctionnalités et les sections qui s'y rapportent.

Voici les principales différences entre le débogueur CLR et le débogueur Visual Studio, conformément à ce qui est décrit dans la documentation :

  • Le débogueur CLR ne prend pas en charge le débogage des applications Win32 en code natif. Seules les applications écrites et compilées pour le Common Language Runtime peuvent être déboguées à l'aide du débogueur CLR.

  • Le débogage distant n'est pas implémenté dans le débogueur CLR.

  • La fenêtre Registres est implémentée dans le débogueur CLR, mais aucune information de Registre n'apparaît dans la fenêtre. D'autres opérations impliquant des registres ou des pseudo-registres, telles que l'affichage ou la modification d'une valeur de Registre, ne sont pas prises en charge. Pour plus d'informations, consultez Comment : utiliser la fenêtre Registres.

  • La fenêtre Code Machine est implémentée dans le débogueur CLR, mais montre le code machine qui serait généré pour l'application s'il était compilé en tant que code natif Win32 plutôt qu'en tant que code du Common Language Runtime. Pour plus d'informations, consultez Comment : utiliser la fenêtre Code Machine.

  • Le débogueur CLR ne prend pas en charge l'aide accessible par la touche F1.

  • Le débogueur CLR ne prend pas en charge la fonctionnalité de fenêtre Automatique.

Modèle de la solution du débogueur CLR

Le débogueur CLR utilise des solutions pour associer les fichiers sources aux applications en cours de débogage. Lorsque vous ouvrez une application compilée et les fichiers sources associés, une solution est automatiquement créée. Lors du prochain débogage de la même application, vous pourrez ouvrir la solution au lieu d'avoir à charger le fichier source et l'application compilée séparément.

Pour ouvrir une application en vue du débogage (la première fois)

  1. Démarrez le débogueur CLR ; exécutez DbgCLR.exe, qui figure dans le répertoire GuiDebug de votre installation .NET Framework.

  2. Dans le menu Déboguer, sélectionnez Programme à déboguer.

  3. Dans la boîte de dialogue Programme à déboguer, accédez à la zone Programme, puis cliquez sur le bouton de sélection (...). La boîte de dialogue Rechercher le programme à déboguer s'affiche.

  4. Naviguez jusqu'au répertoire qui contient le fichier EXE que vous souhaitez déboguer, puis sélectionnez ce dernier.

  5. Cliquez sur Ouvrir.

    Vous revenez à la boîte de dialogue Programme à déboguer. Notez que le Répertoire de travail correspond au répertoire qui contient votre EXE.

  6. Dans la zone Arguments, tapez les arguments requis par votre programme.

  7. Cliquez sur OK.

  8. Dans le menu Fichier, sélectionnez Ouvrir, puis cliquez sur Fichier.

  9. Dans la boîte de dialogue Ouvrir un fichier, choisissez le fichier source à ouvrir.

  10. Cliquez sur OK.

  11. Pour ouvrir des fichiers sources supplémentaires, répétez les étapes 8 à 10.

Ce processus crée automatiquement une solution pour votre session de débogage. Si vous sélectionnez Démarrer ou Étape, la boîte de dialogue Enregistrer le fichier sous s'ouvre pour que vous puissiez enregistrer la solution. Si vous sélectionnez Quitter ou Fermer la solution, un message s'affiche pour vous inviter à enregistrer d'abord la solution.

Pour ouvrir une solution existante

  • Dans le menu Fichier, choisissez Ouvrir.

Voir aussi

Référence

Invite de commandes du Kit de développement SDK

Autres ressources

Débogage dans Visual Studio