Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Vous pouvez déboguer des projets Office à 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 possibilité d’insérer des points d’arrêt et d’afficher des variables dans la fenêtre Locals , sont également disponibles lorsque vous déboguez des projets Office. Pour plus d’informations sur les outils de débogage Visual Studio, consultez Déboguer dans Visual Studio.
Conseil / Astuce
Pour simplifier le débogage, fermez toutes les instances ouvertes de l’application Office avant de la générer et de la déboguer.
S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document et aux projets de complément VSTO. Consultez les fonctionnalités disponibles par type d’application et de projet Office.
Note
Vous souhaitez développer des solutions qui étendent l’expérience Office sur plusieurs plateformes ? Consultez le nouveau modèle de compléments Office. Les compléments Office ont une petite empreinte par rapport aux compléments et solutions VSTO, et vous pouvez les créer à l’aide de presque toutes les technologies de programmation web, telles que HTML5, JavaScript, CSS3 et XML.
Démarrer et arrêter le débogueur
Vous pouvez commencer à déboguer un projet Office comme vous commencez à déboguer d’autres projets Visual Studio ; par exemple, vous pouvez appuyer sur la touche F5 . Lorsque vous démarrez le débogage d’un projet de complément VSTO, un nouveau processus pour l’application Office ciblée est démarré et le complément VSTO est chargé.
Lorsque vous démarrez le débogage d’un projet au niveau du document, le document ou le classeur s’ouvre dans un nouveau processus Word ou Excel.
Lorsque vous arrêtez le débogueur, celui-ci met fin de manière abrupte au processus d'application ou effectue un détachement si le débogueur est configuré pour ça. Tous les autres documents ouverts dans le processus d’application Office terminé sont également fermés sans avertissement, et toutes les modifications non enregistrées sont perdues. Cela peut inclure tous les documents ou classeurs ouverts pendant le fonctionnement du débogueur.
En règle générale, il est préférable de se détacher du processus avant d’arrêter le débogueur, afin que vous puissiez quitter l’application Office de la façon normale. Vous pouvez également vous détacher du processus en premier si vous souhaitez toujours utiliser un document ou une feuille de calcul ouvert après l’arrêt du débogueur.
Si vous déboguez une personnalisation au niveau du document pour Word, l’arrêt répété du débogueur et la fermeture soudaine de Word peuvent entraîner l’endommagement du modèle Normal. Si cela se produit, vous pouvez supprimer le modèle Normal endommagé et il sera automatiquement recréé la prochaine fois que vous ouvrez Word. Toutefois, les macros qui ont été stockées dans le modèle Normal ne sont pas recréées.
Déboguer des compléments VSTO Office 2013 à l’aide d’Office 2013 ou d’Office 2016
Si vous utilisez Visual Studio 2015 et que les deux versions d’Office sont installées côte à côte, Visual Studio démarre Office 2016. Si vous utilisez Visual Studio 2013, Visual Studio démarre Office 2013.
Si vous souhaitez déboguer votre complément VSTO à l’aide d’une autre version d’Office (2013 ou 2016), ouvrez le Concepteur de projets et, dans l’onglet Débogage , choisissez le bouton d’option Démarrer le programme externe . Ensuite, naviguez vers l’emplacement de l’exécutable du logiciel Office approprié.
Comportement F10 et F11
Lorsque vous démarrez le débogage d’un projet Office, F10 et F11 n’ont pas le même comportement que lorsque vous commencez à déboguer d’autres projets Visual Basic ou C#. Dans les projets Visual Basic ou C#, le débogueur s’arrête sur la fonction principale ; dans les projets Office, Visual Studio n’a pas de contrôle sur la fonction principale de l’application Office. Toutefois, pendant le débogage, F10 et F11 ont les mêmes fonctions que dans les projets Visual Basic et C#.
Afficher les exceptions
En raison de la façon dont le code managé interagit avec du code non managé, Visual Studio n’affiche pas les erreurs levées par les applications Microsoft Office. Par exemple, si un complément VSTO créé à l’aide d’outils de développement Office dans Visual Studio lève une exception, l’application Microsoft Office continue sans afficher d’erreur. Pour voir ces erreurs, configurez le débogueur pour s'arrêter sur les exceptions d'exécution du langage commun. Pour plus d’informations, consultez Gérer les exceptions avec le débogueur.
Si vous définissez le débogueur pour s'arrêter sur les exceptions Common Language Runtime, toutes les exceptions s'arrêteront désormais dans le débogueur, y compris celles que vous avez gérées et certaines exceptions de premier niveau du runtime lui-même, qui pourraient ne pas être pertinentes pour votre projet. Les erreurs indiquant que msosec est introuvable apparaissent dans chaque projet, mais peuvent être ignorées sans risque. Ces exceptions msosec n’affectent pas votre solution.
Vous pouvez également utiliser les instructions Try...Catch autour de vos méthodes pour intercepter les exceptions.
Par défaut, Visual Studio n'affiche pas non plus les erreurs de débogage Just-In-Time pour les projets Office ; toutefois, vous pouvez activer cette option afin de voir les erreurs qui surviennent. Pour plus d’informations, consultez le débogage Just-In-Time dans Visual Studio.
Arguments de ligne de commande
Si l’action de démarrage sur la page de propriétés Debug est définie sur 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.
Gestion des sources
Les propriétés de débogage ne sont pas partagées entre plusieurs utilisateurs sous gestion de 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 (ProjectName.vbproj.user ou ProjectName.csproj.user), et ce fichier n’est pas sous contrôle de code source. Si plusieurs personnes déboguent, chaque personne doit entrer manuellement les propriétés de débogage.
Déboguer des jeux de données mis en cache dans un projet de niveau documentaire
Chaque fois que vous générez un projet, le jeu de données est vidé et recréé. Si vous souhaitez déboguer un jeu de données mis en cache, vous devez ouvrir le document en dehors de Visual Studio, puis attacher le débogueur.
Déboguer des projets de document Word en fonction du format document Word 97-2003 (*.doc)
Pour déboguer un projet de document Word basé sur le format document Word 97-2003 (/.doc*), vous devez ajouter le dossier du projet à la liste des dossiers approuvés. Pour plus d’informations sur la procédure à suivre, consultez Accorder l’approbation aux documents.
Déboguer les compléments désactivés
Les applications Microsoft Office peuvent désactiver les compléments VSTO qui se comportent de manière inattendue. Une application Microsoft Office désactive les compléments VSTO pour empêcher le chargement du code problématique chaque fois que l’application démarre. Toutefois, il est également facile de provoquer un comportement inattendu pendant le débogage classique. Pour plus d’informations sur la façon de réactiver les compléments VSTO, consultez Guide pratique pour réactiver un complément VSTO désactivé.
Il existe deux types de désactivation que les applications Microsoft Office utilisent pour les compléments VSTO : la désactivation en dur et la désactivation réversible.
Désactivation difficile
La désactivation difficile peut se produire lorsqu’un complément VSTO entraîne la fermeture inattendue de l’application. Cela peut également se produire sur votre ordinateur de développement si vous arrêtez le débogueur pendant l’exécution du Startup gestionnaire d’événements dans votre complément VSTO. Lorsqu’un complément VSTO est désactivé en dur, il apparaît dans la liste Éléments désactivés de l’application.
Si une application Office désactive en dur un complément VSTO créé à l’aide des outils de développement Office dans Visual Studio, l’application désactive uniquement le complément VSTO qui a provoqué l’échec. D’autres compléments VSTO créés à l’aide d’outils de développement Office dans Visual Studio pour cette application Office continueront de se charger.
Désactivation temporaire
La désactivation réversible peut se produire lorsqu’un complément VSTO génère une erreur qui n’entraîne pas la fermeture inattendue de l’application. Par exemple, une application peut désactiver provisoirement un complément VSTO s’il lève une exception non gérée pendant l’exécution du Startup gestionnaire d’événements. Lorsqu’un complément VSTO est désactivé de manière réversible, il apparaît dans la liste compléments d’application inactifs de l’application et l’application modifie la valeur de l’entrée de Registre LoadBehavior pour le complément VSTO pour indiquer qu’elle est déchargée. Pour plus d'informations sur l'entrée de registre LoadBehavior, consultez les entrées de registre pour les compléments de VSTO.
Résoudre les 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 dans Windows pour toutes les exceptions levées lorsque vous installez ou désinstallez des solutions Office. Vous pouvez utiliser ces messages pour résoudre les problèmes d’installation et de déploiement.
Résoudre les erreurs de démarrage à l’aide d’un fichier journal et de messages d’erreur
Le runtime Visual Studio Tools pour Office peut écrire toutes les erreurs qui se produisent au démarrage dans un fichier journal ou afficher chaque erreur 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 une boîte de message, créez une variable d’environnement nommée VSTO_SUPPRESSDISPLAYALERTS et définissez-la sur 0 (zéro). Vous pouvez supprimer les messages en supprimant la variable d’environnement ou en la définissant sur 1 (un).
Pour écrire les erreurs dans un fichier journal, créez une variable d’environnement nommée VSTO_LOGALERTS et définissez-la sur 1 (un). Le runtime Visual Studio Tools pour Office crée le fichier journal dans le dossier qui contient le manifeste de déploiement du complément VSTO, ou dans le dossier qui contient le document ou le classeur associé à la personnalisation. En cas d’échec, Visual Studio Tools pour Office runtime crée le fichier journal dans le dossier %TEMP% local. Pour les compléments VSTO au niveau de l’application, le nom par défaut est le nom du complément.vsto.log. Pour les projets au niveau du document, le nom du fichier journal est le nom du document. extension.log, par exemple ExcelWorkbook1.xlsx.log. Pour arrêter la journalisation des erreurs, supprimez la variable d’environnement ou définissez-la sur 0 (zéro).