Débogage de projets Office

Vous pouvez déboguer des projets Office à l'aide de les mêmes outils Microsoft Visual Studio que vous utilisez pour d'autres projets d' Visual Studio .Les fonctionnalités du débogueur d'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 Office.Pour plus d'informations sur les outils de débogage Visual Studio, consultez Débogage dans Visual Studio.

Conseil
Pour simplifier le débogage, fermez toutes les instances ouvertes de l'application Office avant de le générer et déboguer.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Office 2013 et Office 2010. Pour en savoir plus, 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

Vous pouvez commencer à déboguer un projet Office comme vous commencez à déboguer d'autres projets d' Visual Studio ; par exemple, vous pouvez appuyer sur la touche F5.Lorsque vous commencez à déboguer un projet de complément d'application, un nouveau processus pour l'application Office ciblée est démarré et le complément est chargé.Lorsque vous commencez à déboguer un projet au niveau de le document, le document ou le classeur s'ouvre dans un nouveau processus Word ou excel.

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.Tous les autres documents ouverts dans le processus d'application Office terminé ne sont également fermés sans avertissement, et aucune modification non inscrite sont perdus.Cela peut inclure tous les documents ou classeurs qui sont ouverts pendant que le débogueur est en cours d'exécution.

En général, il est préférable de détachement de processus avant l'arrêt du débogueur, afin que vous puissiez quitter l'application Office de manière normale.Vous pouvez également détacher du processus d'abord si vous souhaitez toujours utiliser un document ou une feuille de calcul après avoir arrêté le débogueur.Pour plus d'informations sur le détachement d'un processus, consultez Comment : détacher tous les processus.

Si vous déboguez une personnalisation au niveau de le document pour Word, en s'arrêtant à plusieurs reprises le débogueur et Word de provoquer fermer soudainement peuvent entraîner le modèle normal devenant endommagé.Dans ce cas, vous pouvez supprimer le modèle Normal.dot endommagé et il sera recréé automatiquement à la prochaine ouverture de Word.Toutefois, les macros stockées dans le modèle Normal ne sont pas recréées.

Comportement des touches F10 et F11

Lorsque vous commencez à déboguer un projet Office, F10 et F11 n'ont pas le même comportement qu'avec d'autres projets Visual Basic ou C#.Dans des projets Visual Basic ou C#, le débogueur s'arrête sur la fonction principale (main) ; dans des projets Office, Visual Studio n'a pas le contrôle sur la fonction principale de l'application Office.Toutefois, lors du débogage, F10 et F11 ont les mêmes fonctions que dans des projets Visual Basic et C#.

Affichage d'exceptions

En raison de la façon dont le code managé interagit avec le code non managé, Visual Studio n'affiche pas les erreurs relevées par les applications Microsoft Office.Par exemple, si un complément créé à l'aide de les Outils de développement Office dans Visual Studio lève une exception, l'application Microsoft Office poursuit sans afficher une erreur.Pour consulter ces erreurs, faites en sorte que le débogueur rompe les exceptions du Common Language Runtime.Pour plus d’informations, consultez Comment : arrêter l'exécution lorsqu'une exception est levée.

Si vous définissez le débogueur pour arrêter sur les exceptions du common langage runtime, toutes les exceptions diviseront maintenant en débogueur, y compris ceux que vous avez géré et des exceptions de première chance au runtime lui-même, qui ne peut pas être approprié à votre projet.Des erreurs faisant référence au fait que msosec est introuvable apparaissent dans chaque projet, mais peuvent être ignorées en toute sécurité.Ces exceptions msosec n'affecteront pas votre solution.

Vous pouvez également utiliser les instructions Try...Catch entourant vos méthodes pour intercepter des exceptions.

Par défaut, Visual Studio n'affiche pas non plus les erreurs de débogage juste-à-temps des projets Office ; toutefois, vous pouvez activer cette fonction pour consulter les erreurs relevées.Pour plus d’informations, consultez Débogage juste-à-temps.

Arguments de la ligne de commande

Si Action de démarrage sur la page de propriétés Déboguer a la valeur Démarrer le projet, Visual Studio n'utilise pas d'arguments de ligne de commande lors du débogage du projet, même si vous avez spécifié des arguments de ligne de commande comme options de démarrage.Si vous souhaitez utiliser des arguments de ligne de commande lorsque vous démarrez le débogage, vous devez sélectionner une Action de démarrage autre que Démarrer le projet.

Contrôle de code source

Les propriétés de débogage ne sont pas partagées entre plusieurs utilisateurs sous contrôle de code source.Les projets Visual Basic et C# stockent les propriétés de débogage dans un fichier spécifique à l'utilisateur (NomprojetNomprojet.vbproj.user ou .csproj.user), et ce fichier n'est pas sous contrôle de code source.Si plusieurs personnes effectuent un débogage, chacune d'entre elles doit entrer manuellement les propriétés de débogage.

Groupe de données mis en cache de débogage dans un projet au niveau de le document

À chaque fois que vous générez un projet, le groupe de données est vidé et recréé.Si vous souhaitez déboguer un groupe de données mis en cache, vous devez ouvrir le document en dehors de Visual Studio, puis attacher le débogueur.

Débogage de projets de document Word 2007 selon le format de document (* .doc) Word 97-2003

Pour déboguer un projet de document Word selon le format de document (* .doc) Word 97-2003, vous devez ajouter le dossier du projet à la liste des dossiers approuvée.Pour plus d'informations sur la procédure à suivre, consultez. Octroi de niveaux de confiance à des documents.

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.

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 pour le complément, ou dans le répertoire qui contient le document ou le classeur associés à la personnalisation.En cas de échec, Visual Studio Tools pour Office Runtime crée le fichier journal dans le dossier local %TEMP%.Pour les compléments au niveau de l'application, le nom par défaut est nom du complément.vsto.log.Pour les projets au niveau de le document, le nom du fichier journal est nom de document.extension.log, par exemple ExcelWorkbook1.xlsx.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é

Autres ressources

Génération de solutions Office

Programmation de compléments d'application