Débogage dans les projets au niveau de l'application

Mise à jour : novembre 2007

Vous pouvez déboguer des projets au niveau de l'application en utilisant les mêmes outils Microsoft Visual Studio que vous utilisez pour d'autres projets Visual Studio. Les fonctionnalités du débogueur Visual Studio (telles que la capacité d'insérer des points d'arrêt et des variables de vue dans la fenêtre Variables locales) sont également disponibles lorsque vous déboguez des projets au niveau de l'application. Pour plus d'informations sur les outils de débogage Visual Studio, consultez Débogage dans Visual Studio. Pour plus d'informations sur les projets au niveau de l'application, consultez Architecture des compléments d'application.

Démarrage et arrêt du débogueur

Pour commencer à déboguer un projet au niveau de l'application, procédez de la même manière que pour d'autres projets Visual Studio ; par exemple, vous pouvez appuyer sur la touche F5. Lorsque vous commencez à déboguer votre projet, un nouveau processus pour l'application Office cible est démarré et le complément est chargé. Lorsque vous arrêtez le débogueur, ce dernier met brusquement fin au processus d'application, ou se détache si vous l'avez configuré pour cela. Pour plus d'informations, consultez Touches de raccourci de débogage, schéma Brief.

Affichage d'exceptions

Si un complément créé à l'aide de Visual Studio Tools pour Office lève une exception, l'application Microsoft Office poursuit sans afficher celle-ci. Définissez le débogueur de sorte qu'il s'arrête sur toutes les exceptions si vous souhaitez savoir à quel moment les exceptions du complément sont levées. Pour plus d'informations, consultez Comment : gérer les erreurs dans les projets Office.

Vous pouvez également insérer des instructions Try...Catch autour du code susceptible de lever une exception. Pour plus d'informations sur l'utilisation des instructions Try...Catch, consultez Comment : tester du code à l'aide d'un bloc Try…Catch dans Visual Basic et Comment : gérer une exception à l'aide de try/catch (Guide de programmation C#).

Débogage de compléments désactivés

Les applications Microsoft Office peuvent désactiver des compléments qui se comportent de façon inattendue, lors de leur chargement. Une application Microsoft Office désactive les compléments pour empêcher le chargement de tout code problématique à chaque fois qu'elle démarre. Toutefois, il peut s'avérer utile de provoquer un comportement inattendu au cours d'un débogage classique. Pour plus d'informations sur la réactivation de compléments, consultez Comment : réactiver un complément qui a été désactivé.

Les applications Microsoft Office utilisent deux types de désactivation pour les compléments : dure et douce.

Désactivation dure

La désactivation dure se produit lorsque le code qui s'exécute lors du chargement du complément entraîne la fermeture inattendue de l'application ou lorsque vous arrêtez le débogueur pendant que le constructeur ou le gestionnaire d'événements Startup s'exécute.

Si une application Microsoft Office 2003 procède à une désactivation dure d'un complément créé en utilisant Visual Studio Tools pour Office, l'application désactive à la fois le complément et AddinLoader.dll. AddinLoader.dll est utilisé pour charger des compléments créés à l'aide de Visual Studio Tools pour Office. Par conséquent, le chargement de tous les compléments créés à l'aide de Visual Studio Tools pour Office pour cette application Microsoft Office est rendu impossible pour l'utilisateur actuel. Pour plus d'informations sur AddinLoader.dll, consultez Architecture des compléments d'application.

Si une version de 2007 de Microsoft Office system désactive de manière dure un complément créé à l'aide de Visual Studio Tools pour Office, l'application désactive uniquement le complément ayant généré l'échec. En conséquence, d'autres compléments créés à l'aide de Visual Studio Tools pour Office pour cette application Office 2007 continueront à se charger.

Désactivation douce

La désactivation douce se produit lorsqu'un complément lève une exception non gérée dans le constructeur ou dans le gestionnaire d'événements Startup et que l'application Microsoft Office ne se ferme pas de manière inattendue. L'application peut désactiver uniquement le chargement du complément actuel pour l'utilisateur actuel. Lorsqu'une application désactive de manière douce un complément, elle affecte la valeur 2 à l'entrée du Registre LoadBehavior pour le complément. L'entrée LoadBehavior se situe sous la clé de Registre suivante : HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office \<Nom Application> \Addins\<nom complément>. Pour plus d'informations sur cette clé de Registre, consultez Entrées du Registre pour les compléments d'application.

Dépannage de compléments à l'aide d'un journal et de messages d'erreur

L'exécution Visual Studio Tools pour Office peut consigner toutes les erreurs qui se produisent au démarrage dans un fichier journal ou afficher chacune d'elles dans un message. Par défaut, ces options sont désactivées. Vous pouvez activer les options en créant des variables d'environnement.

Pour afficher chaque erreur dans un message, créez une variable d'environnement nommée VSTO_SUPPRESSDISPLAYALERTS et affectez-lui la valeur 0 (zéro). Vous pouvez supprimer les messages en supprimant la variable d'environnement ou en lui affectant la valeur 1 (un).

Pour consigner les erreurs dans un fichier journal, créez une variable d'environnement appelée VSTO_LOGALERTS et affectez-lui la valeur 1 (un). L'exécution Visual Studio Tools pour Office crée le fichier journal dans le dossier qui contient le manifeste de l'application. Le nom par défaut est <NomManifeste>.manifest.log. Pour arrêter la journalisation des erreurs, supprimez la variable d'environnement ou affectez-lui la valeur 0 (zéro). 

Voir aussi

Tâches

Comment : réactiver un complément qui a été désactivé

Comment : gérer les erreurs dans les projets Office

Concepts

Programmation de compléments d'application

Autres ressources

Génération et débogage de solutions Office