Partager via

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

  • Article

Cette procédure pas à pas d'introduction vous indique comment créer une personnalisation au niveau du document pour Microsoft Office Excel. Les fonctionnalités que vous créez dans ce genre de solution sont disponibles uniquement quand un classeur spécifique est ouvert. Vous ne pouvez pas utiliser une personnalisation au niveau du document pour apporter des changements à l'échelle de l'application, par exemple afficher un nouvel onglet de ruban quand 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 application Office lication et le type de projet.

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 quand elle est ouverte.

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

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

    Remarque

    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.

Prérequis

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

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.

    Remarque

    Vous pouvez également rechercher des modèles en tapant le nom du produit Bureau 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 Bureau en sélectionnant Bureau dans la zone de liste déroulante Type de projet. Pour plus d’informations, consultez Créer un projet dans Visual Studio.

  4. Sélectionnez 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 dans 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 l'ensemble des feuilles de calcul et des graphiques.

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

    • Sheet2 (fichier .vb pour le fichier Visual Basic ou .cs pour Visual C#) : feuille de calcul qui fournit l’aire de conception et le code de la deuxième feuille de calcul du classeur.

    • Sheet3 (fichier .vb pour le fichier Visual Basic ou .cs pour Visual C#) : feuille de calcul qui fournit l’aire 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 Feuil1 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 Explorateur de solutions, cliquez avec le bouton droit sur le fichier de code Sheet1, puis cliquez sur Concepteur de vues.

    - ou -

    Dans 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 aux cellules, appliquer des formules ou ajouter des contrôles Excel. Pour plus d’informations sur l’utilisation du concepteur, consultez Bureau projets dans l’environnement Visual Studio.

Pour ajouter une feuille de calcul à votre document à 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.

Avertissement

Si vous ajoutez cette ligne de texte à la cellule A2, elle sera remplacée par d’autres codes dans cet exemple.

Ajouter du texte à une feuille de calcul par programmation

L'étape suivante consiste à ajouter du code au fichier de code Feuil1. 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 Feuil1 contient le code généré suivant :

  • Une définition partielle de la classe Sheet1, qui représente le modèle de programmation de la feuille de calcul et permet d'accéder 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 classe Sheet1 est défini dans un fichier de code masqué que vous ne devez pas modifier.

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

Pour ajouter une deuxième ligne de texte à la feuille de calcul en utilisant du code

  1. Dans Explorateur de solutions, cliquez avec le bouton droit sur Feuille1, 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. Quand Feuil1 est ouvert, ce code ajoute une deuxième ligne de texte à la feuille de calcul.

    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.

    Quand vous générez le projet, le code est compilé dans un assembly qui est associé au classeur. Visual Studio place une copie du classeur et de l’assembly dans le dossier de sortie de la génération du projet. Par ailleurs, il 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 Générer des solutions Bureau.

  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é via le code.

  3. Fermez le classeur.

Nettoyer le projet

Une fois que vous avez fini de développer un projet, vous devez supprimer les fichiers du dossier de sortie de génération 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

Une fois que vous avez créé une personnalisation de base au niveau du document pour Excel, vous pouvez en apprendre plus sur la manière de développer des personnalisations dans les rubriques suivantes :

  • 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 : Bureau personnalisation de l’interface utilisateur.

  • Utilisation d’objets Excel étendus fournis par Bureau outils de développement 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 Bureau.

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

Contenu connexe