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

Vous pouvez déboguer des projets au niveau de l'application à l'aide des 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 d'afficher des variables 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.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau application pour Microsoft Office 2010 et la version 2007 de Microsoft® Office System. Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Pour une démonstration vidéo connexe, consultez Comment faire pour déboguer une application VSTO ? (page éventuellement en anglais).

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 Debugging Shortcut Keys, Brief Scheme.

Affichage d'exceptions

Si un complément créé à l'aide des outils de développement Office dans Visual Studio lève une exception, l'application Microsoft Office poursuit sans afficher cette exception. 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. 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 définitive peut se produire lorsqu'un complément provoque la fermeture inattendue de l'application. Elle peut également se produire sur votre ordinateur de développement lorsque vous arrêtez le débogueur alors que le gestionnaire d'événements Startup de votre complément s'exécute. Lorsqu'un complément a été désactivé de façon définitive, il figure dans la liste Éléments désactivés de l'application.

Si une application Office procède à une désactivation dure d'un complément créé à l'aide des outils de développement Office dans Visual Studio, l'application désactive uniquement le complément ayant généré l'échec. Les autres compléments créés à l'aide des outils de développement Office dans Visual Studio pour cette application Office continueront à se charger.

Désactivation douce

La désactivation temporaire peut se produire lorsqu'un complément génère une erreur qui ne provoque pas la fermeture inattendue de l'application. Par exemple, une application peut désactiver un complément de façon temporaire s'il lève une exception non gérée durant l'exécution du gestionnaire d'événements Startup. Lorsqu'un complément est désactivé de façon temporaire, il apparaît dans la liste des Compléments d'applications inactifs de l'application et cette dernière modifie la valeur de l'entrée de Registre LoadBehavior du complément pour indiquer qu'il a été est déchargé. Pour plus d'informations sur l'entrée du Registre LoadBehavior, consultez Entrées du Registre pour les compléments d'application.

Résolution des erreurs d'installation à l'aide de l'observateur d'événements

Visual Studio Tools pour Office Runtime écrit des messages dans l'observateur d'événements de Windows, pour toutes les exceptions levées lors de l'installation ou de la désinstallation des solutions Office. Vous pouvez utiliser ces messages pour résoudre les éventuels problèmes d'installation et de déploiement. Pour plus d'informations, consultez Journalisation des événements pour les solutions Office.

Résolution des erreurs de démarrage à l'aide d'un fichier journal et des messages d'erreur

Le Visual Studio Tools pour Office Runtime peut consigner toutes les erreurs qui se produisent au démarrage dans un fichier journal ou afficher chacune d'elles dans une boîte de 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). Visual Studio Tools pour Office Runtime crée le fichier journal dans le dossier qui contient le manifeste de déploiement du complément, ou, en cas d'échec, dans le dossier local %TEMP%. Le nom par défaut est nom du complément.vsto.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

Autres ressources

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

Programmation de compléments d'application

Historique des modifications

Date	Historique	Motif
Septembre 2010	Ajout d'une section relative à la résolution des erreurs d'installation à l'aide de l'observateur d'événements.	Améliorations apportées aux informations.
Mai 2010	Correction de certains détails relatifs aux erreurs de journalisation.	Résolution des bogues de contenu.