Tutorial: Depurar un proyecto de complemento
Este tutorial muestra cómo crear un proyecto de complemento Visual Studio simple y cómo utilizar puntos de interrupción para depurar el proyecto. Para obtener más información, vea Puntos de interrupción y puntos de seguimiento.
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.
Nota
Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos. Estos procedimientos se han desarrollado con la Configuración de desarrollo general activa. Para cambiar la configuración, elija la opción Importar y Exportar configuraciones en el menú Herramientas. Para obtener más información, vea Trabajar con valores de configuración.
Para crear un proyecto de complemento sencillo en Visual Studio
En el menú Archivo, elija Nuevo y haga clic en Proyecto.
Aparecerá el New Project Dialog Box.
En el panel Tipos de proyecto, expanda Otros tipos de proyectos y, a continuación, seleccione Extensibilidad.
En el panel Plantillas, seleccione Complemento de Visual Studio.
En campo Nombre, escriba SimpleAddIn como nombre del proyecto de complemento. Haga clic en Aceptar.
Se iniciará el Welcome to the Add-In Wizard, Visual Studio Add-In Wizard.
En la página Asistente para complementos, haga clic en Siguiente.
En la página Seleccione un lenguaje de programación, haga clic en Crear un complemento utilizando Visual C# y, a continuación, haga clic en Siguiente.
En la página Seleccione una aplicación host, acepte las opciones predeterminadas y después haga clic en Siguiente.
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 del complemento. Haga clic en Siguiente.
En la página Elegir opciones de complemento, active la opción Sí, crear un elemento de menú Herramientas. Acepte los valores predeterminados restantes. Haga clic en Siguiente.
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, haga clic en Siguiente.
En la página Resumen, haga clic en Finalizar.
El Asistente para complementos genera el nuevo proyecto de complemento y abre el IDE con el foco en el archivo Connect.cs. Ésta es la clase principal que contiene el código para el complemento.
En el Explorador de soluciones, haga clic con el botón secundario del mouse en el nodo Referencias y seleccione Agregar referencia para agregar una referencia al ensamblado.
Esto permite el uso de tipos en el espacio de nombres System.Windows.Forms.
Aparecerá el Add Reference Dialog Box.
En la ficha .NET, haga doble clic en el componente, System.Windows.Forms.dll.
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.
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;Agregue un objeto MessageBox al complemento agregandoMessageBox.Show("Debugging a Simple Add-in"); al método Exec de Connect.cs:
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; } } }Haga clic en el botón Guardar todo para guardar el trabajo.
Para depurar el proyecto de complemento de Visual Studio
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 (interrupción) y el texto de la línea queda resaltado en color rojo.
En el menú Depurar, haga clic en 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.
En el IDE de Visual Studio que se está depurando, haga clic en el menú Herramientas.
SimpleAddIn está al principio de la lista de elementos de menú.
Seleccione el comando SimpleAddIn para ejecutar el complemento.
Irá a la línea donde se establece el punto de interrupción en la sesión de depurador de Visual Studio, que se resalta en amarillo.
En el menú Depurar de la sesión de depurador, elija 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.
Haga clic en Aceptar para cerrar el cuadro de mensaje.
En la sesión del depurador, seleccione Continuar en el menú Depurar.
La sesión de Visual Studio depurada recobra el foco.
Salga de la sesión de Visual Studio depurada.
En Connect.cs, haga clic en el punto de interrupción que estableció junto a la instrucción MessageBox para quitarla del código fuente.
Cuando puede ver, cuando depure un complemento, se abrirá otra instancia del IDE de Visual Studio para hospedar el complemento en ejecución. La primera instancia muestra el código y permite realizar la depuración, por ejemplo estableciendo variables de inspección, puntos de interrupción, etc. Cuando se finaliza la depuración, la segunda instancia del IDE se cierra y vuelve al código del complemento en la primera instancia.