Procédure pas à pas : création de votre première personnalisation au niveau du document pour ExcelWalkthrough: Creating Your First Document-Level Customization for Excel

Cette procédure pas à pas d'introduction vous indique comment créer une personnalisation au niveau du document pour Microsoft Office Excel.This introductory walkthrough shows you how to create a document-level customization for 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.The features that you create in this kind of solution are available only when a specific workbook is open. 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.You cannot use a document-level customization to make application-wide changes, for example, displaying a new Ribbon tab when any workbook is open.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document pour Excel.Applies to: The information in this topic applies to document-level projects for Excel. Pour plus d’informations, consultez Fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features Available by Office Application and Project Type.

Cette procédure pas à pas décrit les tâches suivantes :This walkthrough illustrates the following tasks:

  • Création d'un projet de classeur Excel.Creating an Excel workbook project.

  • Ajout de texte à une feuille de calcul hébergée dans le concepteur Visual Studio.Adding text to a worksheet that is hosted in the Visual Studio designer.

  • É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.Writing code that uses the object model of Excel to add text to the customized worksheet when it is opened.

  • Génération et exécution du projet pour le testerBuilding and running the project to test it.

  • Nettoyage du projet achevé pour supprimer les fichiers de build et les paramètres de sécurité inutiles de votre ordinateur de développement.Cleaning up the completed project to remove unnecessary build files and security settings from your development computer.

    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.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments.The Visual Studio edition that you have and the settings that you use determine these elements. Pour plus d'informations, consultez Personnalisation de l'IDE.For more information, see Personalizing the IDE.

PrérequisPrerequisites

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :You need the following components to complete this walkthrough:

Création du projetCreating the Project

Pour créer un projet de classeur Excel dans Visual StudioTo create a new Excel workbook project in Visual Studio

  1. Démarrez Visual StudioVisual Studio.Start Visual StudioVisual Studio.

  2. Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet.On the File menu, point to New, and then click Project.

  3. Dans le volet Modèles, développez Visual C# ou Visual Basic, puis développez Office/SharePoint.In the templates pane, expand Visual C# or Visual Basic, and then expand Office/SharePoint.

  4. Sous le nœud développé Office/SharePoint , sélectionnez le nœud Compléments Office .Under the expanded Office/SharePoint node, select the Office Add-ins node.

  5. Dans la liste des modèles de projet, choisissez un projet de complément Excel VSTO.In the list of project templates, choose an Excel VSTO Add-in project.

  6. Dans le nom , tapez FirstWorkbookCustomization.In the Name box, type FirstWorkbookCustomization.

  7. Cliquez sur OK.Click OK.

    L' Assistant Projet Visual Studio Tools pour Office s'ouvre.The Visual Studio Tools for Office Project Wizard opens.

  8. Sélectionnez créer un nouveau document, puis cliquez sur OK.Select Create a new document, and click OK.

    • Visual StudioVisual Studio crée le FirstWorkbookCustomization le projet, puis ajoute les fichiers suivants au projet. creates the FirstWorkbookCustomization project, and adds the following files to the project.

    • FirstWorkbookCustomization.xlsx - représente le classeur Excel dans le projet.FirstWorkbookCustomization.xlsx - Represents the Excel workbook in the project. Contient l'ensemble des feuilles de calcul et des graphiques.Contains all the worksheets and charts.

    • Feuil1 (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - Feuille de calcul qui fournit l'aire de conception et le code de la première feuille de calcul dans le classeur.Sheet1 (.vb file for Visual Basic or .cs file for Visual C#) - A worksheet that provides the design surface and the code for the first worksheet in the workbook. Pour plus d'informations, consultez Worksheet Host Item.For more information, see Worksheet Host Item.

    • Feuil2 (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - Feuille de calcul qui fournit l'aire de conception et le code de la deuxième feuille de calcul dans le classeur.Sheet2 (.vb file for Visual Basic or .cs file for Visual C#) - A worksheet that provides the design surface and the code for the second worksheet in the workbook.

    • Feuil3 (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - Feuille de calcul qui fournit l'aire de conception et le code de la troisième feuille de calcul dans le classeur.Sheet3 (.vb file for Visual Basic or .cs file for Visual C#) - A worksheet that provides the design surface and the code for the third worksheet in the workbook.

    • ThisWorkbook (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - Contient l'aire de conception et le code pour les personnalisations au niveau du classeur.ThisWorkbook (.vb file for Visual Basic or .cs file for Visual C#) - Contains the design surface and the code for workbook-level customizations. Pour plus d'informations, consultez Workbook Host Item.For more information, see Workbook Host Item.

      Le fichier de code Feuil1 est ouvert automatiquement dans le concepteur.The Sheet1 code file is opened automatically in the designer.

Fermeture et réouverture des feuilles de calcul dans le concepteurClosing and Reopening Worksheets in the Designer

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.If you deliberately or accidentally close a workbook or a worksheet in the designer while you are developing your project, you can reopen it.

Pour fermer et rouvrir une feuille de calcul dans le concepteurTo close and reopen a worksheet in the designer

  1. Fermez le classeur en cliquant sur le fermer bouton (X) de la fenêtre du concepteur.Close the workbook by clicking the Close button (X) for the designer window.

  2. Dans l’Explorateur de solutions, avec le bouton droit le Feuil1 fichier de code, puis cliquez sur Concepteur de vue.In Solution Explorer, right-click the Sheet1 code file, and click View Designer.

    - ou -- or -

    Dans l’Explorateur de solutions, double-cliquez sur le Feuil1 fichier de code.In Solution Explorer, double-click the Sheet1 code file.

Ajout de texte à une feuille de calcul dans le concepteurAdding Text to a Worksheet in the Designer

Vous pouvez concevoir l'interface utilisateur de votre personnalisation en modifiant la feuille de calcul ouverte dans le concepteur.You can design the user interface (UI) of your customization by modifying the worksheet that is open in the designer. Par exemple, vous pouvez ajouter du texte aux cellules, appliquer des formules ou ajouter des contrôles Excel.For example, you can add text to cells, apply formulas, or add Excel controls. Pour plus d’informations sur l’utilisation du concepteur, consultez les projets Office dans l’environnement Visual Studio.For more information about how to use the designer, see Office Projects in the Visual Studio Environment.

Pour ajouter une feuille de calcul à votre document à l'aide du concepteurTo add text to a worksheet by using the designer

  1. Dans la feuille de calcul ouverte dans le concepteur, sélectionnez la cellule A1, puis tapez le texte suivant.In the worksheet that is open in the designer, select cell A1, and then type the following text.

    Ce texte a été ajouté à l’aide du concepteur.This text was added by using the designer.

Avertissement

Si vous ajoutez cette ligne de texte à la cellule A2, il sera remplacé par un autre code dans cet exemple.If you add this line of text to cell A2, it will be overwritten by other code in this example.

Ajout de texte à une feuille de calcul par programmationAdding Text to a Worksheet Programmatically

L'étape suivante consiste à ajouter du code au fichier de code Feuil1.Next, add code to the Sheet1 code file. Le nouveau code utilise le modèle objet d'Excel pour ajouter une deuxième ligne de texte au classeur.The new code uses the object model of Excel to add a second line of text to the workbook. Par défaut, le fichier de code Feuil1 contient le code généré suivant :By default, the Sheet1 code file contains the following generated code:

  • 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.A partial definition of the Sheet1 class, which represents the programming model of the worksheet and provides access to the object model of Excel. Pour plus d’informations, élément hôte de feuille de calcul et présentation du modèle objet de Word.For more information, Worksheet Host Item and Word Object Model Overview. Le reste de la classe Sheet1 est défini dans un fichier de code masqué que vous ne devez pas modifier.The remainder of the Sheet1 class is defined in a hidden code file that you should not modify.

  • Les gestionnaires d'événements Sheet1_Startup et Sheet1_Shutdown.The Sheet1_Startup and Sheet1_Shutdown event handlers. Ces gestionnaires d'événements sont appelés quand Excel charge et décharge votre personnalisation.These event handlers are called when Excel loads and unloads your customization. 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.Use these event handlers to initialize your customization when it is loaded, and to clean up resources used by your customization when it is unloaded. Pour plus d'informations, consultez Events in Office Projects.For more information, see Events in Office Projects.

Pour ajouter une deuxième ligne de texte à la feuille de calcul en utilisant du codeTo add a second line of text to the worksheet by using code

  1. Dans l’Explorateur de solutions, avec le bouton droit Feuil1, puis cliquez sur afficher le Code.In Solution Explorer, right-click Sheet1, and then click View Code.

    Le fichier de code s'ouvre dans Visual Studio.The code file opens in Visual Studio.

  2. Remplacez le gestionnaire d'événements Sheet1_Startup par le code suivant.Replace the Sheet1_Startup event handler with the following code. Quand Feuil1 est ouvert, ce code ajoute une deuxième ligne de texte à la feuille de calcul.When Sheet1 is opened, this code adds a second line of text to the worksheet.

    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";
    }
    
    Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
        Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
            Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
        nr.Value2 = "This text was added by using code"
    End Sub
    

Test du projetTesting the Project

Pour tester votre classeurTo test your workbook

  1. Appuyez sur F5 pour générer et exécuter votre projet.Press F5 to build and run your project.

    Quand vous générez le projet, le code est compilé dans un assembly qui est associé au classeur.When you build the project, the code is compiled into an assembly that is associated with the workbook. 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.Visual Studio puts a copy of the workbook and the assembly in the build output folder for the project, and it configures the security settings on the development computer to enable the customization to run. Pour plus d’informations, consultez génération de Solutions Office.For more information, see Building Office Solutions.

  2. Dans le classeur, vérifiez que vous voyez le texte suivant.In the workbook, verify that you see the following text.

    Ce texte a été ajouté à l’aide du concepteur.This text was added by using the designer.

    Ce texte a été ajouté via le code.This text was added by using code.

  3. Fermez le classeur.Close the workbook.

Nettoyage du projetCleaning up the Project

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.When you finish developing a project, you should remove the files in the build output folder and the security settings created by the build process.

Pour nettoyer le projet terminé sur votre ordinateur de développementTo clean up the completed project on your development computer

  1. Dans Visual Studio, dans le menu Générer , cliquez sur Nettoyer la solution.In Visual Studio, on the Build menu, click Clean Solution.

Étapes suivantesNext Steps

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 :Now that you have created a basic document-level customization for Excel, you can learn more about how to develop customizations from these topics:

Voir aussiSee Also

Présentation du développement de Solutions Office (VSTO) Office Solutions Development Overview (VSTO)
Solutions Excel Excel Solutions
Programmation des personnalisations au niveau du Document Programming Document-Level Customizations
Vue d’ensemble du modèle d’objet Excel Excel Object Model Overview
Automatisation d’Excel à l’aide d’objets étendus Automating Excel by Using Extended Objects
Personnalisation de l’interface utilisateur Office Office UI Customization
Génération de Solutions Office Building Office Solutions
Déploiement d’une Solution Office Deploying an Office Solution
Vue d’ensemble des modèles de projet OfficeOffice Project Templates Overview