Agregar controles NamedRange a hojas de cálculo

Puede agregar controles NamedRange a una hoja de cálculo de Microsoft Office Excel en tiempo de diseño y en tiempo de ejecución, en los proyectos de nivel de documento.

Se aplica a: La información de este tema se aplica a proyectos de nivel de documento y proyectos de complementos de VSTO para Excel. Para obtener más información, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

También puede agregar controles NamedRange en tiempo de ejecución a los proyectos de complementos VSTO.

En este tema se describen las tareas siguientes:

Agregar controles NamedRange en tiempo de diseño

Existen varias maneras de agregar controles NamedRange a una hoja de cálculo en un proyecto de nivel de documento en tiempo de diseño: desde Excel, desde el Cuadro de Herramientasde Visual Studio y desde la ventana Orígenes de datos .

Nota:

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Personalizar el IDE.

Para agregar un control NamedRange a una hoja de cálculo usando el cuadro de nombre en Excel

  1. Seleccione las celdas que quiere incluir en el rango con nombre.

  2. En el cuadro Nombre, escriba un nombre para el intervalo y presione Entrar.

    El cuadro de nombre s está situado al lado de la barra de fórmulas, justo sobre la columna A de la hoja de cálculo.

Para agregar un control NamedRange a una hoja de cálculo con el cuadro de herramientas

  1. Abra el Cuadro de herramientas y haga clic en la pestaña Controles de Excel .

  2. Haga clic en NamedRange y arrástrelo a una hoja de cálculo.

    Aparece el cuadro de diálogo Agregar rango con nombre .

  3. Seleccione las celdas que quiere incluir en el rango con nombre.

  4. Haga clic en OK.

    Si no quiere usar el nombre predeterminado que se le ha dado al control puede cambiarlo en la ventana Propiedades .

Para agregar un control NamedRange a una hoja de cálculo con la ventana Orígenes de datos

  1. Abra la ventana Orígenes de datos y cree un origen de datos para su proyecto. Para más información, consulte Adición de una nueva conexión.

  2. Arrastre un único campo desde la ventana Orígenes de datos hasta su hoja de cálculo.

    Un control NamedRange enlazado a los datos se agrega a la hoja de cálculo. Para obtener más información, consulte Enlace de datos y Formularios Windows Forms.

Agregar controles NamedRange en tiempo de ejecución en un proyecto de nivel de documento

Puede agregar un control NamedRange mediante programación a la hoja de cálculo en tiempo de ejecución. Esto le permite crear los controles host en respuesta a eventos. Los rangos con nombre creados de forma dinámica no se conservan en la hoja de cálculo como controles host cuando esta se cierra. Para obtener más información, vea Agregar controles a documentos de Office en tiempo de ejecución.

Para agregar un control NamedRange a una hoja de cálculo mediante programación

  1. En el controlador de eventos Startup de Sheet1, inserte el siguiente código para agregar el control NamedRange a la celda A1 y establezca su propiedad Value2 en Hello world!.

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

Agregar controles NamedRange en tiempo de ejecución en un proyecto de complemento de VSTO

Puede agregar un control NamedRange mediante programación a cualquier hoja de cálculo abierta de un proyecto de complemento de VSTO. Los rangos con nombre creados de forma dinámica no se conservan en la hoja de cálculo como controles host cuando esta se cierra. Para obtener más información, vea Extender documentos de Word y libros de Excel en complementos de VSTO en tiempo de ejecución.

Para agregar un control NamedRange a una hoja de cálculo mediante programación

  1. El siguiente código crea un elemento host de hoja de cálculo que se basa en la hoja de cálculo abierta; a continuación, agrega un control NamedRange a la celda A1 y establece su propiedad Value2 en 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";
     }