Procédure pas à pas : Créer votre première personnalisation au niveau du document pour Excel

Cette procédure pas à pas d’introduction vous montre comment créer une personnalisation au niveau du document pour Microsoft Office Excel. Les fonctionnalités que vous créez dans ce type de solution sont disponibles uniquement lorsqu’un classeur spécifique est ouvert. Vous ne pouvez pas utiliser une personnalisation au niveau du document pour apporter des modifications à l’échelle de l’application, par exemple, afficher un nouvel onglet ruban lorsqu’un classeur est ouvert.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document pour Excel. Pour plus d’informations, consultez Fonctionnalités disponibles par type d’application et de projet Office.

Cette procédure pas à pas décrit les tâches suivantes :

• Création d’un projet de classeur Excel.

• Ajout de texte à une feuille de calcul hébergée dans le concepteur Visual Studio.

• Écriture de code qui utilise le modèle objet d’Excel pour ajouter du texte à la feuille de calcul personnalisée lorsqu’elle est ouverte.

• Génération et exécution du projet pour le tester.

• Nettoyage du projet terminé pour supprimer les fichiers de build et les paramètres de sécurité inutiles de votre ordinateur de développement.

  Note

  Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d’informations, consultez Personnaliser l’IDE.

Prerequisites

Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :

• Édition de Visual Studio qui inclut les outils de développement Microsoft Office. Pour plus d’informations, consultez Configurer un ordinateur pour développer des solutions Office.

• Excel 2013 ou Excel 2010 .

Créer le projet

Pour créer un projet de classeur Excel dans Visual Studio

1. Démarrez Visual Studio.

2. Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet.

3. Dans la boîte de dialogue Créer un projet, sélectionnez le projet de classeur VSTO Excel .

   Note

   Vous pouvez également rechercher des modèles en tapant le nom du produit Office dans la zone de texte Rechercher en haut de la boîte de dialogue Créer un projet . Par exemple, la saisie d’Excel affiche tous les modèles de projet pour Excel. Vous pouvez également filtrer la liste des modèles pour afficher uniquement les modèles pour Office en sélectionnant Office dans la zone de liste déroulante Type de projet. Pour plus d’informations, consultez Créer un projet dans Visual Studio.

4. Cliquez sur Suivant.

5. Tapez FirstWorkbookCustomization dans la zone Nom dans la boîte de dialogue Configurer votre nouveau projet , puis cliquez sur Créer.

6. Sélectionnez Créer un document à partir de l’Assistant Projet Visual Studio Tools pour Office, puis cliquez sur OK.

   • Visual Studio crée le projet FirstWorkbookCustomization et ajoute les fichiers suivants au projet.

   • FirstWorkbookCustomization.xlsx : représente le classeur Excel dans le projet. Contient toutes les feuilles de calcul et graphiques.

   • Sheet1 (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) : Feuille de calcul fournissant la surface de conception et le code de la première feuille du classeur. Pour plus d’informations, consultez l’élément hôte de feuille de calcul.

   • Feuille2 (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - Une feuille de calcul qui fournit la surface de conception et le code de la deuxième feuille de calcul du classeur.

   • Sheet3 (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) : feuille qui fournit la surface de conception et le code de la troisième feuille de calcul du classeur.

   • ThisWorkbook (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - contient l’aire de conception et le code des personnalisations au niveau du classeur. Pour plus d’informations, consultez l’élément hôte du classeur.

     Le fichier de code Sheet1 est ouvert automatiquement dans le concepteur.

Fermer et rouvrir des feuilles de calcul dans le concepteur

Si vous fermez délibérément ou accidentellement un classeur ou une feuille de calcul dans le concepteur pendant que vous développez votre projet, vous pouvez le rouvrir.

Pour fermer et rouvrir une feuille de calcul dans le concepteur

1. Fermez le classeur en cliquant sur le bouton Fermer (X) pour la fenêtre du concepteur.

2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le fichier de code Sheet1 , puis cliquez sur Concepteur de vues.

   - ou -

   Dans l’Explorateur de solutions, double-cliquez sur le fichier de code Sheet1 .

Ajouter du texte à une feuille de calcul dans le concepteur

Vous pouvez concevoir l’interface utilisateur de votre personnalisation en modifiant la feuille de calcul ouverte dans le concepteur. Par exemple, vous pouvez ajouter du texte à des cellules, appliquer des formules ou ajouter des contrôles Excel. Pour plus d’informations sur l’utilisation du concepteur, consultez les projets Office dans l’environnement Visual Studio.

Pour ajouter du texte à une feuille de calcul à l’aide du concepteur

1. Dans la feuille de calcul ouverte dans le concepteur, sélectionnez la cellule A1, puis tapez le texte suivant.

   Ce texte a été ajouté à l’aide du concepteur.

Ajouter du texte à une feuille de calcul par programmation

Ensuite, ajoutez du code au fichier de code Sheet1. Le nouveau code utilise le modèle objet d’Excel pour ajouter une deuxième ligne de texte au classeur. Par défaut, le fichier de code Sheet1 contient le code généré suivant :

• Définition partielle de la Sheet1 classe, qui représente le modèle de programmation de la feuille de calcul et fournit l’accès au modèle objet d’Excel. Pour plus d’informations, vue d’ensemble de l’élément hôte de feuille de calcul et du modèle objet Word. Le reste de la Sheet1 classe est défini dans un fichier de code masqué que vous ne devez pas modifier.

• Gestionnaires d’événements Sheet1_Startup et Sheet1_Shutdown. Ces gestionnaires d’événements sont appelés lorsque Excel charge et décharge votre personnalisation. Utilisez ces gestionnaires d’événements pour initialiser votre personnalisation lorsqu’elle est chargée et pour nettoyer les ressources utilisées par votre personnalisation lorsqu’elle est déchargée. Pour plus d’informations, consultez Événements dans les projets Office.

Pour ajouter une deuxième ligne de texte à la feuille de calcul à l’aide du code

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Sheet1, puis cliquez sur Afficher le code.

   Le fichier de code s’ouvre dans Visual Studio.

2. Remplacez le gestionnaire d’événements Sheet1_Startup par le code suivant. Lorsque la feuille Sheet1 est ouverte, ce code ajoute une deuxième ligne de texte à la feuille de calcul.

   • C#
   • VB

   private void Sheet1_Startup(object sender, System.EventArgs e)
   {
       Microsoft.Office.Tools.Excel.NamedRange nr =
           this.Controls.AddNamedRange(this.Range["A2"], "NamedRange1");
       nr.Value2 = "This text was added by using code";
   }
   

Tester le projet

Pour tester votre classeur

1. Appuyez sur F5 pour générer et exécuter votre projet.

   Lorsque vous générez le projet, le code est compilé dans un assembly associé au classeur. Visual Studio place une copie du classeur et de l’assembly dans le dossier de sortie de build du projet, et configure les paramètres de sécurité sur l’ordinateur de développement pour permettre l’exécution de la personnalisation. Pour plus d’informations, consultez Créer des solutions Office.

2. Dans le classeur, vérifiez que vous voyez le texte suivant.

   Ce texte a été ajouté à l’aide du concepteur.

   Ce texte a été ajouté à l’aide du code.

3. Fermez le classeur.

Nettoyer le projet

Lorsque vous avez terminé le développement d’un projet, vous devez supprimer les fichiers dans le dossier de sortie de build et les paramètres de sécurité créés par le processus de génération.

Pour nettoyer le projet terminé sur votre ordinateur de développement

1. Dans Visual Studio, dans le menu Générer, cliquez sur Nettoyer la solution.

Étapes suivantes

Maintenant que vous avez créé une personnalisation au niveau du document de base pour Excel, vous pouvez en savoir plus sur le développement de personnalisations à partir de ces rubriques :

• Tâches de programmation générales que vous pouvez effectuer dans les personnalisations au niveau du document : Personnalisations au niveau du document du programme.

• Tâches de programmation spécifiques aux personnalisations au niveau du document pour Excel : solutions Excel.

• Utilisation du modèle objet d’Excel : Vue d’ensemble du modèle objet Excel.

• Personnalisation de l’interface utilisateur d’Excel, par exemple, en ajoutant un onglet personnalisé au ruban ou en créant votre propre volet Actions : Personnalisation de l’interface utilisateur d’Office.

• Utilisation d’objets Excel étendus fournis par les outils de développement Office dans Visual Studio pour effectuer des tâches qui ne sont pas possibles à l’aide du modèle objet Excel (par exemple, l’hébergement de contrôles managés sur les documents et la liaison de contrôles Excel aux données à l’aide du modèle de liaison de données Windows Forms) : Automatisez Excel à l’aide d’objets étendus.

• Création et débogage de personnalisations au niveau du document pour Excel : Créer des solutions Office.

• Déploiement de personnalisations au niveau du document pour Excel : Déployer une solution Office.

Contenu connexe

• Vue d’ensemble du développement de solutions Office (VSTO)
• Solutions Excel
• Personnalisations au niveau du document du programme
• Vue d’ensemble du modèle objet Excel
• Automatiser Excel à l’aide d’objets étendus
• Personnalisation de l’interface utilisateur Office
• Créer des solutions Office
• Déployer une solution Office
• Vue d’ensemble des modèles de projet Office