Ajouter des contrôles NamedRange aux feuilles de calcul

Vous pouvez ajouter des contrôles NamedRange à une feuille de calcul Microsoft Office Excel au moment de la conception et au moment de l’exécution dans des projets au niveau du document.

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

Vous pouvez aussi ajouter des contrôles NamedRange au moment de l’exécution dans des projets de complément VSTO.

Cette rubrique décrit les tâches suivantes :

Ajouter des contrôles NamedRange au moment du design

Il existe plusieurs façons d’ajouter des contrôles NamedRange à une feuille de calcul dans un projet au niveau du document au moment de la conception : dans Excel, à partir de la Boîte à outilsVisual Studio, et à partir de la fenêtre Sources de données .

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.

Pour ajouter un contrôle NamedRange à une feuille de calcul via la Zone Nom d’Excel

  1. Sélectionnez la ou les cellules que vous souhaitez inclure dans l'étendue nommée.

  2. Dans la zone Nom, tapez un nom pour la plage, puis appuyez sur Entrée.

    La Zone Nom se trouve à côté de la barre de formule, juste au-dessus de la colonne A de la feuille de calcul.

Pour ajouter un contrôle NamedRange à une feuille de calcul via la Boîte à outils

  1. Ouvrez la Boîte à outils , puis cliquez sur l’onglet Contrôles Excel .

  2. Cliquez sur NamedRange et faites-le glisser vers une feuille de calcul.

    La boîte de dialogue Ajouter une plage nommée s’affiche.

  3. Sélectionnez la ou les cellules que vous souhaitez inclure dans l'étendue nommée.

  4. Cliquez sur OK.

    Si vous ne voulez pas du nom attribué par défaut au contrôle, vous pouvez le modifier dans la fenêtre Propriétés .

Pour ajouter un contrôle NamedRange à une feuille de calcul via la fenêtre Sources de données

  1. Ouvrez la fenêtre Sources de données et créez une source de données pour votre projet. Pour plus d’informations, consultez Ajouter de nouvelles connexions.

  2. Faites glisser un seul champ de la fenêtre Sources de données vers votre feuille de calcul.

    Un contrôle NamedRange lié aux données est ajouté à la feuille de calcul. Pour plus d’informations, consultez Liaison de données et Windows Forms.

Ajouter des contrôles NamedRange au moment de l’exécution dans un projet au niveau du document

Vous pouvez ajouter un NamedRange contrôle par programmation à votre feuille de calcul au moment de l’exécution. Cela vous permet de créer les contrôles hôtes en réponse à des événements. Les plages nommées créées dynamiquement ne sont pas conservées dans la feuille de calcul en tant que contrôles hôtes au moment où la feuille de calcul est fermée. Pour plus d’informations, consultez Ajouter des contrôles à Bureau documents au moment de l’exécution.

Pour ajouter un contrôle NamedRange à une feuille de calcul par programmation

  1. Dans le gestionnaire d’événements Startup de Sheet1, insérez le code suivant pour ajouter le contrôle NamedRange à la cellule A1 et attribuez à sa propriété Value2 la valeur Hello world!

    Microsoft.Office.Tools.Excel.NamedRange textInCell;
    textInCell = this.Controls.AddNamedRange(this.get_Range("A1"), "cellText");
    
    textInCell.Value2 = "Hello world!";
    

Ajouter des contrôles NamedRange au moment de l’exécution dans un projet de complément VSTO

Vous pouvez ajouter par programmation un contrôle NamedRange à une feuille de calcul ouverte dans un projet de complément VSTO. Les plages nommées créées dynamiquement ne sont pas conservées dans la feuille de calcul en tant que contrôles hôtes au moment où la feuille de calcul est fermée. Pour plus d’informations, consultez Étendre les documents Word et les classeurs Excel dans les compléments VSTO au moment de l’exécution.

Pour ajouter un contrôle NamedRange à une feuille de calcul par programmation

  1. Le code suivant génère un élément hôte de feuille de calcul basé sur la feuille de calcul ouverte, puis ajoute un contrôle NamedRange à la cellule A1 et attribue à sa propriété Value2 la valeur Hello world.

    private void AddNamedRange()
    {
        Microsoft.Office.Tools.Excel.NamedRange textInCell;
    
        Worksheet worksheet = Globals.Factory.GetVstoObject(
            Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets[1]);
    
    
        Excel.Range cell = worksheet.Range["A1"]; 
        textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange");
        textInCell.Value2 = "Hello World";
     }