Partager via

Créer un complément de contenu Excel

  • Article

Dans cet article, vous allez parcourir le processus de création d’un complément de contenu Excel à l’aide de Visual Studio.

Configuration requise

  • Visual Studio 2019 ou une version ultérieure avec la charge de travail de développement Office/SharePoint installée.

    Remarque

    Si vous avez déjà installé Visual Studio, utilisez le programme d'installation de Visual Studio pour vous assurer que la charge de travail de développement Office/SharePoint est installée.

  • Office connecté à un abonnement Microsoft 365 (y compris Office on the web).

Création du projet de complément

  1. Dans Visual Studio, choisissez Créer un nouveau projet.

  2. À l’aide de la zone de recherche, entrez complément. Choisissez Complément web Excel, puis sélectionnez Suivant.

  3. Nommez votre projet ExcelWebAddIn1, puis sélectionnez Créer.

  4. Dans la boîte de dialogue Créer un complément Office , choisissez le type de complément Insérer du contenu dans les feuilles de calcul Excel , puis choisissez Suivant.

  5. Choisissez le modèle Complément de base ou Complément de visualisation de document, puis choisissez Terminer pour créer le projet.

  6. Visual Studio crée une solution et ses deux projets apparaissent dans l’Explorateur de solutions. Le fichier Home.html s’ouvre dans Visual Studio.

Explorer la solution Visual Studio

Quand vous arrivez au bout de l’Assistant, Visual Studio crée une solution qui contient deux projets.

Project Description
Projet de complément Contient uniquement un fichier manifeste de complément au format XML, qui contient tous les paramètres qui décrivent votre complément. Ces paramètres aident l’application Office à déterminer le moment où votre complément doit être activé et l’emplacement où il doit apparaître. Visual Studio génère le contenu de ce fichier pour vous permettre d’exécuter le projet et d’utiliser votre complément immédiatement. Modifiez ces paramètres à tout moment en modifiant le fichier XML.
Projet d’application web Contient les pages de contenu de votre complément, notamment tous les fichiers et références de fichiers dont vous avez besoin pour développer des pages HTML et JavaScript compatibles avec Office. Pendant que vous développez votre complément, Visual Studio héberge l’application web sur votre serveur IIS local. Lorsque vous êtes prêt à publier le complément, vous devez déployer ce projet d’application web sur un serveur web.

Mise à jour du manifeste

  1. Dans l’explorateur de solutions, accédez au projet de complément ExcelWebAddIn1, puis ouvrez le répertoire ExcelWebAddIn1Manifest. Ce répertoire contient votre fichier manifeste, ExcelWebAddIn1.xml. Le fichier manifeste définit les paramètres et les fonctionnalités du complément. Consultez la section Explore the Visual Studio solution précédente pour plus d’informations sur les deux projets créés par votre solution Visual Studio.

  2. L’élément ProviderName possède une valeur d’espace réservé. Remplacez-le par votre nom.

  3. L’attribut DefaultValue de l’élément DisplayName possède un espace réservé. Remplacez-le par My Office Add-in.

  4. L’attribut DefaultValue de l’élément Description possède un espace réservé. Remplacez-le par un complément de contenu pour Excel.

  5. Enregistrez le fichier. Les lignes mises à jour doivent ressembler à l’exemple de code suivant.

    ...
<ProviderName>John Doe</ProviderName>
<DefaultLocale>en-US</DefaultLocale>
<!-- The display name of your add-in. Used on the store and various places of the Office UI such as the add-ins dialog. -->
<DisplayName DefaultValue="My Office Add-in" />
<Description DefaultValue="A content add-in for Excel."/>
...

Essayez

  1. À l’aide de Visual Studio, testez le complément Excel nouvellement créé en appuyant sur F5 ou en choisissant le bouton Démarrer pour lancer Excel avec le complément de contenu affiché dans la feuille de calcul.

  2. Vérifiez qu’il y a du texte dans la feuille de calcul, puis sélectionnez une plage de cellules contenant du texte dans la feuille de calcul.

  3. Sélectionnez l’onglet du modèle que vous avez choisi, puis suivez les instructions.

    • Dans le complément de contenu, choisissez le bouton Obtenir des données à partir de la sélection pour obtenir le texte de la plage sélectionnée.

      Contenu du complément ouvert dans Excel.

Remarque

Pour voir la sortie console.log, vous devrez disposer d’un ensemble distinct d’outils de développement dédiés à une console JavaScript. Pour en savoir plus sur les outils F12 et les Outils de développement Microsoft Edge, consultez Déboguer des compléments à l’aide des outils de développement pour Internet Explorer, Déboguer des compléments à l’aide des outils de développement pour Edge Legacy, ou Déboguer les compléments à l’aide des outils de développement dans Microsoft Edge (basé sur Chromium).

Étapes suivantes

Félicitations, vous avez créé un complément de contenu Excel ! Ensuite, en savoir plus sur la création de compléments Office avec Visual Studio.

Résolution des problèmes

  • Si votre complément affiche une erreur (par exemple, « Ce complément n’a pas pu être démarré. Fermez cette boîte de dialogue pour ignorer le problème ou cliquez sur « Redémarrer » pour réessayer. ») Lorsque vous appuyez sur F5 ou choisissez Déboguer>Démarrer le débogage dans Visual Studio, consultez Déboguer les compléments Office dans Visual Studio pour obtenir d’autres options de débogage.

Exemples de code

Voir aussi