Procédure pas à pas : création de votre première personnalisation au niveau du document pour Excel

Article
03/04/2013

Cette première procédure pas à pas vous indique comment créer une personnalisation au niveau du document pour Microsoft Office Excel.Les fonctionnalités créées avec ce type de solution ne sont disponibles que lorsqu'un classeur spécifique est ouvert.Vous ne pouvez pas utiliser de personnalisation au niveau du document pour apporter des modifications à l'échelle de l'application (par exemple, pour afficher un nouvel onglet Ruban lorsqu'un nouveau classeur est ouvert).

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document pour Excel 2013 et Excel 2010. Pour en savoir plus, 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 au classeur hébergé dans le concepteur Visual Studio
Écriture de code qui utilise le modèle objet d'Excel pour ajouter du texte au classeur personnalisé lorsqu'il est ouvert
Génération et exécution du projet pour le tester
Nettoyage du projet afin de supprimer les fichiers de build et les paramètres de sécurité inutiles de votre ordinateur de développement

[!REMARQUE]

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio 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 Paramètres Visual Studio.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :

Une édition de Visual Studio 2012 qui inclut les outils de développement Microsoft Office. Pour plus d'informations, consultez [Configuration d'un ordinateur pour développer des solutions Office](bb398242\(v=vs.110\).md).

Excel 2013 ou Excel 2010.

Création du projet

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

Démarrez Visual Studio.
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.
Dans le volet modèles, développez Visual C# ou Visual Basic, puis développez Office/SharePoint.
Sous le nœud développé Office/SharePoint , sélectionnez le nœud Les compléments Office .
Dans la liste des modèles de projet, sélectionnez Classeur Excel 2010 ou Classeur Excel 2013.
Dans la zone Nom, tapez FirstWorkbookCustomization.
Cliquez sur OK.

L'Assistant Projet Visual Studio Tools pour Office s'ouvre.
Sélectionnez Créer un nouveau document, puis cliquez sur OK.
- Visual Studio crée le projet FirstWorkbookCustomization et y ajoute les fichiers suivants :
- FirstWorkbookCustomization.xlsx - Représente le classeur Excel dans le projet.Contient l'ensemble des feuilles de calcul et des graphiques.
- Sheet1 (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.Pour plus d’informations, consultez Élément hôte de feuille de calcul.
- Sheet2 (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.
- Sheet3 (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.
- 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ément hôte de classeur.
Le fichier de code Sheet1 est ouvert automatiquement dans le concepteur.

Fermeture et réouverture 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 au cours du développement de votre projet, vous pouvez les rouvrir.

Pour fermer et rouvrir une feuille de calcul dans le concepteur

Fermez le classeur en cliquant sur le bouton Fermer (X) de la fenêtre du concepteur.
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.

Ajout de texte à une feuille de calcul dans le concepteur

Vous pouvez concevoir l'interface utilisateur de votre personnalisation en modifiant la feuille de calcul qui est 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 Projets Office dans l'environnement Visual Studio.

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

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

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

Attention
Si vous ajoutez cette ligne de texte à la cellule A2, il sera remplacé par un autre code dans cet exemple.

Ajout de texte à une feuille de calcul par programmation

Ajoutez ensuite du code au fichier de 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 classe Sheet1, qui représente le modèle de programmation de la feuille de calcul et fournit un accès au modèle objet d'Excel.Pour plus d'informations, consultez Élément hôte de feuille de calcul et Vue d'ensemble 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 lorsque Excel charge et décharge votre personnalisation.Utilisez ces gestionnaires d'événements pour initialiser votre personnalisation lorsqu'elle est chargée, et 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 de code

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.

Remplacez le gestionnaire d'événements Sheet1_Startup par le code suivant.Lorsque Sheet1 est ouvert, ce code y ajoute une deuxième ligne de texte.

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

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";
}

Test du projet

Pour tester votre classeur

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 l'assembly dans le dossier de sortie de la génération du projet, et il configure les paramètres de sécurité de l'ordinateur de développement afin de permettre l'exécution de la personnalisation.Pour plus d’informations, consultez Génération de solutions Office.
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é en utilisant le code.
Fermez le classeur.

Nettoyage du projet

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

Pour nettoyer le projet de votre ordinateur de développement une fois le projet terminé

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 de document de base pour Word, vous pouvez perfectionner votre connaissance du développement des personnalisations en consultant les rubriques suivantes :

Tâches de programmation générales que vous pouvez effectuer dans les personnalisations au niveau du document : Programmation de personnalisations au niveau du document.
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 grâce à l'ajout d'un onglet personnalisé au ruban ou à la création de votre propre volet d'actions : Personnalisation de l'interface utilisateur Office.
Utilisation d'objets Excel étendus fournis par les outils de développement Office dans Visual Studio pour des tâches qu'il n'est pas possible d'effectuer avec le modèle objet Excel (par exemple, héberger des contrôles managés sur des documents et lier des contrôles Excel aux données à l'aide du modèle de liaison de données Windows Forms) : Automatisation d'Excel à l'aide d'objets étendus.
Génération et débogage des personnalisations au niveau du document pour Excel : Génération de solutions Office.
Déploiement de personnalisations au niveau du document pour Excel : Déploiement d'une solution Office.