Compartir a través de

Tutorial: Crear el primer complemento en el nivel de la aplicación para Excel

  • Artículo

Este tutorial introductorio muestra cómo crear un complemento en el nivel de la aplicación para Microsoft Office Excel.Las características que se crean en este tipo de solución están disponibles para la propia aplicación, con independencia de los libros que estén abiertos.

Se aplica a: La información de este tema se aplica a los proyectos de nivel de aplicación para Excel 2013 y Excel 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

En este tutorial se muestran las tareas siguientes:

  • Crear un proyecto de complemento de Excel.

  • Escribir código que utiliza el modelo de objetos de Excel para agregar texto a un libro cuando se guarda.

  • Compilar y ejecutar el proyecto para probarlo.

  • Limpiar el proyecto completado para que el complemento ya no se ejecute automáticamente en el equipo de desarrollo.

[!NOTA]

Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. 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 Valores de configuración de Visual Studio.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

-

Una edición de Visual Studio 2012 que incluye las herramientas para desarrolladores de Microsoft Office. Para obtener más información, vea [Configurar un equipo para desarrollar soluciones de Office](bb398242\(v=vs.110\).md).
  • Excel 2013 o Excel 2010.

Crear el proyecto

Para crear un nuevo proyecto de complemento de Excel en Visual Studio

  1. Inicie Visual Studio.

  2. En el menú Archivo, elija Nuevo y haga clic en Proyecto.

  3. En el panel de plantillas, expanda Visual c# o Visual Basicy, a continuación Office/SharePoint.

  4. Bajo el nodo expandido Office/SharePoint , seleccione el nodo Office Agregar-INS .

  5. En la lista de plantillas de proyecto, seleccione Complemento de Excel 2010 o Complemento de Excel 2013.

  6. En el cuadro Nombre, escriba FirstExcelAddIn.

  7. Haga clic en Aceptar.

    Visual Studio crea el proyecto FirstExcelAddIn y abre el archivo de código ThisAddIn en el editor.

Escribir código para agregar texto al libro guardado

A continuación, agregue código al archivo de código ThisAddIn.El nuevo código utiliza el modelo de objetos de Excel para insertar texto reutilizable en la primera fila de la hoja de cálculo activa.La hoja de cálculo activa es la hoja que está abierta cuando el usuario guarda el libro.De forma predeterminada, el archivo de código ThisAddIn contiene el código generado siguiente:

  • Una definición parcial de la clase ThisAddIn.Esta clase proporciona un punto de entrada para el código y proporciona acceso al modelo de objetos de Excel.Para obtener más información, vea Programar complementos de nivel de aplicación.El resto de la clase ThisAddIn se define en un archivo de código oculto que no debe modificar.

  • Los controladores de eventos ThisAddIn_Startup y ThisAddIn_Shutdown.Se llama a estos controladores de eventos cuando Excel carga y descarga el complemento.Use estos controladores de eventos para inicializar el complemento cuando éste se cargue y para limpiar los recursos cuando se descargue.Para obtener más información, vea Eventos de los proyectos de Office.

Para agregar una línea de texto al libro guardado

  1. En el archivo de código ThisAddIn, agregue el código siguiente a la clase ThisAddIn.El nuevo código define un controlador de eventos para el evento WorkbookBeforeSave, que se provoca cuando se guarda un libro.

    Cuando el usuario guarda un libro, el controlador de eventos agrega el nuevo texto en el inicio de la hoja de cálculo activa.

    Private Sub Application_WorkbookBeforeSave(ByVal Wb As Microsoft.Office.Interop.Excel.Workbook, ByVal SaveAsUI As Boolean, ByRef Cancel As Boolean) Handles Application.WorkbookBeforeSave
    Dim activeWorksheet As Excel.Worksheet = CType(Application.ActiveSheet, Excel.Worksheet)
    Dim firstRow As Excel.Range = activeWorksheet.Range("A1")
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown)
    Dim newFirstRow As Excel.Range = activeWorksheet.Range("A1")
    newFirstRow.Value2 = "This text was added by using code"
End Sub

    void Application_WorkbookBeforeSave(Microsoft.Office.Interop.Excel.Workbook Wb, bool SaveAsUI, ref bool Cancel)
{
    Excel.Worksheet activeWorksheet = ((Excel.Worksheet)Application.ActiveSheet);
    Excel.Range firstRow = activeWorksheet.get_Range("A1");
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1");
    newFirstRow.Value2 = "This text was added by using code";
}

  2. Si utiliza C#, agregue el siguiente código necesario al controlador de eventos ThisAddIn_Startup.Este código se utiliza para conectar el controlador de eventos Application_WorkbookBeforeSave al evento WorkbookBeforeSave.

    this.Application.WorkbookBeforeSave += new Microsoft.Office.Interop.Excel.AppEvents_WorkbookBeforeSaveEventHandler(Application_WorkbookBeforeSave);

Para modificar el libro al guardarlo, los ejemplos de código anteriores utilizan los objetos siguientes:

Probar el proyecto

Para probar el proyecto

  1. Presione F5 para compilar y ejecutar el proyecto.

    Al generar el proyecto, el código se genera en un ensamblado que se incluye en la carpeta de resultado de compilación del proyecto.Visual Studio también crea un conjunto de entradas del Registro que permiten que Excel detecte y cargue el complemento, y establece la configuración de seguridad en el equipo de desarrollo a fin de permitir la ejecución del complemento.Para obtener más información, vea Compilar soluciones de Office.

  2. En Excel, guarde el libro.

  3. Compruebe que el texto siguiente se agrega al libro.

    Este texto se agregó mediante código.

  4. Cierre Excel.

Limpiar el proyecto

Al terminar de desarrollar un proyecto, quite el ensamblado de complemento, las entradas del Registro y la configuración de seguridad del equipo de desarrollo.De lo contrario, el complemento continuará ejecutándose cada vez que abra Excel en este equipo.

Para limpiar el proyecto completado en el equipo de desarrollo

  • En el menú Compilar de Visual Studio, haga clic en Limpiar solución.

Pasos siguientes

Ahora que ha creado un complemento básico en el nivel de la aplicación para Excel, puede obtener más información sobre la programación de complementos en estos temas:

Vea también

Conceptos

Información general sobre el desarrollo de soluciones de Office

Otros recursos

Soluciones de Excel

Programar complementos de nivel de aplicación

Información general sobre el modelo de objetos de Excel

Personalización de la interfaz de usuario de Office

Compilar soluciones de Office

Implementar una solución de Office

Información general sobre las plantillas de Office Project