Comment : ajouter des contrôles NamedRange aux feuilles de calculHow to: Add NamedRange controls to worksheets

Vous pouvez ajouter NamedRange contrôles à une feuille de calcul Microsoft Office Excel au moment du design et de l’exécution dans les projets au niveau du document.You can add NamedRange controls to a Microsoft Office Excel worksheet at design time and at runtime in document-level projects.

S’applique à : les informations contenues dans cette rubrique s’applique au document-projets et ajouter de VSTO de niveau-dans les projets pour Excel.Applies to: The information in this topic applies to document-level projects and VSTO Add-in 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.

Vous pouvez également ajouter NamedRange contrôles lors de l’exécution dans les projets de complément VSTO.You can also add NamedRange controls at runtime in VSTO Add-in projects.

Cette rubrique décrit les tâches suivantes :This topic describes the following tasks:

Ajouter des contrôles NamedRange au moment du designAdd NamedRange controls at design time

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 .There are several ways to add NamedRange controls to a worksheet in a document-level project at design time: from within Excel, from the Visual Studio Toolbox, and from the Data Sources window.

> [!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 Personnaliser l’IDE.For more information, see Personalize the IDE.

Pour ajouter un contrôle NamedRange à une feuille de calcul via la Zone Nom d’ExcelTo add a NamedRange control to a worksheet using the Name Box in Excel

  1. Sélectionnez la ou les cellules que vous souhaitez inclure dans l'étendue nommée.Select the cell or cells you want to include in the named range.

  2. Dans le zoneNom, tapez un nom pour la plage et appuyez sur entrée.In the Name Box, type a name for the range and press Enter.

    La Zone Nom se trouve à côté de la barre de formule, juste au-dessus de la colonne A de la feuille de calcul.The Name Box is located beside the formula bar, just above column A of the worksheet.

Pour ajouter un contrôle NamedRange à une feuille de calcul via la Boîte à outilsTo add a NamedRange control to a worksheet using the Toolbox

  1. Ouvrez la Boîte à outils , puis cliquez sur l’onglet Contrôles Excel .Open the Toolbox and click the Excel Controls tab.

  2. Cliquez sur NamedRange et faites-le glisser vers une feuille de calcul.Click NamedRange and drag it to a worksheet.

    La boîte de dialogue Ajouter une plage nommée s’affiche.The Add Named Range dialog box appears.

  3. Sélectionnez la ou les cellules que vous souhaitez inclure dans l'étendue nommée.Select the cell or cells you want to include in the named range.

  4. Cliquez sur OK.Click 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 .If you do not want the default name that is given to the control, you can change the name in the Properties window.

Pour ajouter un contrôle NamedRange à une feuille de calcul via la fenêtre Sources de donnéesTo add a NamedRange control to a worksheet using the Data Sources window

  1. Ouvrez la fenêtre Sources de données et créez une source de données pour votre projet.Open the Data Sources window and create a data source for your project. Pour plus d’informations, consultez ajouter de nouvelles connexions.For more information, see Add new connections.

  2. Faites glisser un seul champ de la fenêtre Sources de données vers votre feuille de calcul.Drag a single field from the Data Sources window to your worksheet.

    Un contrôle NamedRange lié aux données est ajouté à la feuille de calcul.A data-bound NamedRange control is added to the worksheet. Pour plus d’informations, consultez liaison de données et Windows Forms.For more information, see Data binding and Windows Forms.

Ajouter des contrôles NamedRange au moment de l’exécution dans un projet au niveau du documentAdd NamedRange controls at runtime in a document-level project

Vous pouvez ajouter un NamedRange contrôle par programmation à votre feuille de calcul lors de l’exécution.You can add a NamedRange control programmatically to your worksheet at runtime. Cela vous permet de créer les contrôles hôtes en réponse à des événements.This enables you to create the host controls in response to events. 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.Dynamically created named ranges are not persisted in the worksheet as host controls when the worksheet is closed. Pour plus d’informations, consultez ajouter des contrôles aux documents Office au moment de l’exécution.For more information, see Add controls to Office documents at runtime.

Pour ajouter un contrôle NamedRange à une feuille de calcul par programmationTo add a NamedRange control to a worksheet programmatically

  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!In the Startup event handler of Sheet1, insert the following code to add the NamedRange control to cell A1 and set its Value2 property to Hello world!

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

Ajouter des contrôles NamedRange au moment de l’exécution dans un projet de complément VSTOAdd NamedRange controls at runtime in a VSTO Add-in project

Vous pouvez ajouter par programmation un contrôle NamedRange à une feuille de calcul ouverte dans un projet de complément VSTO.You can add a NamedRange control programmatically to any open worksheet in a VSTO Add-in project. 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.Dynamically created named ranges are not persisted in the worksheet as host controls when the worksheet is closed. Pour plus d’informations, consultez documents Word d’étendre et classeurs Excel dans des Compléments VSTO lors de l’exécution.For more information, see Extend Word documents and Excel workbooks in VSTO Add-ins at runtime.

Pour ajouter un contrôle NamedRange à une feuille de calcul par programmationTo add a NamedRange control to a worksheet programmatically

  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.The following code generates a worksheet host item that is based on the open worksheet, and then adds a NamedRange control to cell A1 and sets its Value2 property to 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";
     }
    
    Private Sub AddNamedRange()
        Dim textInCell As Microsoft.Office.Tools.Excel.NamedRange
    
        Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
            Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets(1)
    
        Dim worksheet As Microsoft.Office.Tools.Excel.Worksheet =
            Globals.Factory.GetVstoObject(NativeWorksheet)
    
        Dim cell As Excel.Range = worksheet.Range("A1")
        textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange")
        textInCell.Value2 = "Hello World"
    End Sub
    

Voir aussiSee also

Étendre des documents Word et classeurs Excel dans des Compléments VSTO lors de l’exécution Extend Word documents and Excel workbooks in VSTO Add-ins at runtime
Contrôles sur des documents Office Controls on Office documents
NamedRange (contrôle) NamedRange control
Automatiser Excel à l’aide d’objets étendus Automate Excel by using extended objects
Éléments hôtes et la vue d’ensemble des contrôles hôtes Host items and host controls overview
Comment : redimensionner les contrôles NamedRange How to: Resize NamedRange controls
Limitations de programmation des éléments hôtes et contrôles hôtesProgrammatic limitations of host items and host controls