Compartir a través de

Tutorial: Depurar un proyecto de complemento

  • Artículo

En Visual Studio 2013, los complementos están desusados. Se recomienda actualizar los complementos a las extensiones de VSPackage. Para obtener más información sobre cómo usar actualizar, vea Preguntas más frecuentes: Convertir complementos en extensiones de VSPackage.

Este tutorial muestra cómo crear un proyecto de complemento Visual Studio básico y cómo utilizar puntos de interrupción para depurarlo. Para obtener más información, vea Breakpoints and Tracepoints.

Los complementos son aplicaciones compiladas que utilizan el modelo de objetos de automatización de Visual Studio para manipular o automatizar el entorno de desarrollo integrado (IDE). Para obtener más información, vea Crear complementos y asistentes.

NotaNota

Es posible que su 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 tenga y la configuración que esté usando determinan estos elementos.Para obtener más información, vea Personalizar la configuración de desarrollo en Visual Studio.

Para crear un proyecto de complemento básico en Visual Studio

  1. En la barra de menús, elija Archivo, Nuevo, Proyecto.

    Aparecerá el New Project Dialog Box.

  2. En el panel Tipos de proyecto, expanda Otros tipos de proyectos y, a continuación, seleccione Extensibilidad.

  3. En el panel Plantillas, seleccione Complemento de Visual Studio.

  4. En el campo Nombre, escriba SimpleAddIn. elija el botón de Aceptar .

    Se iniciará el Add-in Wizard.

  5. En la página Asistente para complementos, elija el botón Siguiente.

  6. En la página Seleccione un lenguaje de programación, seleccione Crear un complemento utilizando Visual C# y, a continuación, elija Siguiente.

  7. En la página Seleccione una aplicación host, acepte las opciones predeterminadas y después elija Siguiente.

  8. En la página Especifique un nombre y una descripción, escriba Complemento sencillo como nombre del complemento y escriba Se utiliza para ilustrar la forma de depurar un complemento sencillo como descripción. Elija Siguiente.

  9. En la página Elegir opciones de complemento, seleccione la opción Sí, crear un elemento de menú Herramientas, acepte los valores predeterminados restantes y, a continuación, elija Siguiente.

  10. En la página Elección de información para Ayuda - Acerca de, active la opción Sí, me gustaría que mi complemento ofreciera información en el cuadro Acerca de y, a continuación, elija Siguiente.

  11. En la página de Resumen, elija el botón de Finalizar .

    El Asistente para complementos genera el nuevo proyecto de complemento y abre el archivo Connect.cs. Ésta es la clase principal que contiene el código para el complemento.

  12. En Explorador de soluciones, en el menú contextual del proyecto, elija el botón de Agregar, Referencias, y elija el botón Agregar nueva referencia.

    Esto permite el uso de tipos en el espacio de nombres System.Windows.Forms.

    Aparece el cuadro de diálogo Add Reference.

  13. En la pestaña .NET, seleccione System.Windows.Forms.dll y, a continuación, elija el botón Aceptar.

    En el Explorador de soluciones, se muestra una referencia al espacio de nombres System.Windows.Forms bajo el nodo Referencias.

    Este espacio de nombres contiene el código necesario para mostrar un Cuadro de mensaje, que se utiliza en el ejemplo de código siguiente.

  14. En Connect.cs, agregue la instrucción siguiente cerca de la parte superior del ámbito SimpleAddIn para permitir un uso más fácil de un objeto MessageBox:

    using System.Windows.Forms;

  15. Agregue un objeto MessageBox al complemento agregando MessageBox.Show("Debugging a Simple Add-in"); al método Exec:

    public void Exec(string commandName,
   vsCommandExecOption executeOption,
   ref object varIn, ref object varOut, ref bool handled)
{
   handled = false;
   if(executeOption ==
      vsCommandExecOption.vsCommandExecOptionDoDefault)
   {
      if(commandName == "MyAddin1.Connect.MyAddin1")
      {
         handled = true;
         MessageBox.Show("Debugging a Simple Add-in");
         return;
      }
   }
}

  16. Elija el botón Guardar todo para guardar el trabajo.

Para depurar el proyecto de complemento de Visual Studio

  1. En Connect.cs, haga clic en el margen izquierdo junto a la instrucción:

    MessageBox.Show("Debugging a Simple Add-in")

    Aparece un punto rojo (que simboliza un punto de interrupción) y el texto de la línea queda resaltado en color rojo.

  2. En la barra de menú, elija Depurar, Iniciar depuración.

    La sesión de Visual Studio actual (la sesión del depurador) perderá el foco y el programa que se está depurando de abrirá en otra instancia de Visual Studio.

  3. En la barra de menús de la instancia de la depuración de Visual Studio, elija Herramientas, SimpleAddIn para ejecutar el complemento.

    Irá al punto de interrupción que estableció.

  4. En la barra de menús de la instancia de la depuración, elija Depurar, Paso a paso por instrucciones.

    El foco cambia de nuevo al programa que se está depurando. Se abre el cuadro de mensaje para indicar que se ha ejecutado el complemento.

  5. Elija el botón Aceptar para cerrar el cuadro de mensaje.

  6. En la barra de menús de la instancia de la depuración, elija Depurar, Continuar.

    Cierre la instancia de depuración de Visual Studio.

  7. En Connect.cs, quite el punto de interrupción junto a la instrucción MessageBox.

Vea también

Otros recursos

Crear complementos y asistentes

Referencia de automatización y extensibilidad