Comment : ajouter des contrôles NamedRange aux feuilles de calculHow to: Add NamedRange Controls to Worksheets

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.You can add NamedRange controls to a Microsoft Office Excel worksheet at design time and at run time in document-level projects.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document et aux projets de compléments VSTO 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 aussi ajouter des contrôles NamedRange au moment de l’exécution dans des projets de complément VSTO.You can also add NamedRange controls at run time in VSTO Add-in projects.

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

Adding NamedRange Controls at Design TimeAdding 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 Personnalisation de l'IDE.For more information, see Personalizing 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 la Zone Nom, 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 Data Binding and Windows Forms.For more information, see Data Binding and Windows Forms.

Adding NamedRange Controls at Run Time in a Document-Level ProjectAdding NamedRange Controls at Run Time in a Document-Level Project

Vous pouvez ajouter un NamedRange contrôle par programmation à votre feuille de calcul au moment de l’exécution.You can add a NamedRange control programmatically to your worksheet at run time. 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 Ajout de contrôles à des documents Office au moment de l'exécution.For more information, see Adding Controls to Office Documents at Run Time.

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!"
    

Adding NamedRange Controls at Run Time in an VSTO Add-in projectAdding NamedRange Controls at Run Time in an VSTO Add-in project

Vous pouvez ajouter un contrôle NamedRange par programmation à une feuille de calcul ouverte dans un projet de complément VSTO.You can add a NamedRange control programmatically to any open worksheet in an 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 Extension de documents Word et de classeurs Excel dans des compléments VSTO au moment de l'exécution.For more information, see Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.

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

Extension de Documents Word et classeurs Excel dans des Compléments VSTO au moment de l’exécution Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time
Contrôles sur des Documents Office Controls on Office Documents
NamedRange (contrôle) NamedRange Control
Automatisation d’Excel à l’aide d’objets étendus Automating Excel by Using Extended Objects
Vue d'ensemble des éléments hôtes et 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 des contrôles hôtesProgrammatic Limitations of Host Items and Host Controls