Depurar proyectos de nivel de aplicación

Puede depurar los proyectos de nivel de aplicación con las mismas herramientas de Microsoft Visual Studio que usa para otros proyectos de Visual Studio. Las características del depurador de Visual Studio, como la capacidad de insertar puntos de interrupción y de ver las variables en la ventana Variables locales, también están disponibles al depurar proyectos de nivel de aplicación. Para obtener más información sobre las herramientas de depuración de Visual Studio, vea Depurar en Visual Studio. Para obtener más información sobre los proyectos de nivel de aplicación, vea Arquitectura de los complementos de nivel de aplicación.

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

Dispone de una demostración en vídeo relacionada en How Do I: Debug a VSTO Application?.

Iniciar y detener el depurador

Puede iniciar la depuración de un proyecto de nivel de aplicación de la misma forma que inicia la depuración de otros proyectos de Visual Studio; por ejemplo, puede presionar la tecla F5. Cuando inicia la depuración del proyecto, se inicia un nuevo proceso para la aplicación de Office de destino y se carga el complemento. Cuando el depurador se detiene, éste finaliza repentinamente el proceso de la aplicación o se desasocia si el depurador está configurado para desasociar. Para obtener más información, vea Debugging Shortcut Keys, Brief Scheme.

Mostrar excepciones

Si un complemento creado con las herramientas de desarrollo de Office en Visual Studio produce una excepción, la aplicación de Microsoft Office continúa sin mostrar la excepción. Establezca el depurador para que se interrumpa cuando se produzcan excepciones si desea ver cuándo se inician las excepciones de complementos. Para obtener más información, vea Cómo: Controlar errores en proyectos de Office.

También puede insertar las instrucciones Try...Catch alrededor del código que podría iniciar una excepción. Para obtener más información acerca de cómo utilizar las instrucciones Try...Catch, vea Cómo: Comprobar código con un bloque Try...Catch en Visual Basic y Cómo: Controlar una excepción mediante Try y Catch (Guía de programación de C#).

Depurar complementos deshabilitados

Las aplicaciones de Microsoft Office pueden deshabilitar complementos que tienen un comportamiento inesperado. Una aplicación de Microsoft Office deshabilita los complementos para evitar que se cargue código problemático cada vez que se inicia la aplicación. Sin embargo, también es fácil que se produzca un comportamiento inesperado durante la depuración típica. Para obtener información sobre cómo volver a habilitar complementos, vea Cómo: Volver a habilitar un complemento que se ha deshabilitado.

Hay dos tipos de deshabilitación que las aplicaciones de Microsoft Office utilizan para los complementos: completa y parcial.

Deshabilitar de forma completa

La deshabilitación completa se puede producir cuando un complemento hace que la aplicación se cierre inesperadamente. También podría ocurrir en el equipo de desarrollo si se detiene el depurador mientras el controlador de eventos Startup del complemento se está ejecutando. Cuando un complemento se deshabilita completamente, aparece en la lista Elementos deshabilitados de la aplicación.

Si una aplicación de Office deshabilita de forma completa un complemento creado con las herramientas de desarrollo de Office en Visual Studio, la aplicación deshabilita únicamente el complemento que causó el error. Se seguirán cargando otros complementos creados con las herramientas de desarrollo de Office en Visual Studio para esa aplicación de Office.

Deshabilitación parcial

La deshabilitación parcial se puede producir cuando un complemento genera un error que no hace que la aplicación se cierre inesperadamente. Por ejemplo, una aplicación podría deshabilitar parcialmente un complemento si produce una excepción no controlada mientras el controlador de eventos Startup se está ejecutando. Cuando un complemento se deshabilita parcialmente, aparece en la lista Complementos de aplicaciones inactivas de la aplicación, y esta cambia el valor de la entrada del Registro LoadBehavior correspondiente al complemento para indicar que se descargó. Para obtener más información sobre la entrada del Registro LoadBehavior, vea Entradas del Registro de complementos de nivel de aplicación.

Solución de problemas de errores de instalación mediante el Visor de eventos

Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office escribe mensajes en el Visor de eventos de Windows para todas las excepciones que se producen cuando se instalan o desinstalan soluciones de Office. Puede utilizar estos mensajes para resolver problemas de instalación e implementación. Para obtener más información, vea Registro de eventos para soluciones de Office.

Solución de problemas de errores de inicio mediante un archivo de registro y mensajes de error

Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office puede escribir todos los errores que se producen durante el inicio en un archivo de registro o mostrar cada error en un cuadro de mensaje. De forma predeterminada, estas opciones están desactivadas. Es posible activar las opciones si se crean variables de entorno.

Para mostrar cada error en un cuadro de mensaje, cree una variable de entorno denominada VSTO_SUPPRESSDISPLAYALERTS y establézcala en 0 (cero). Puede suprimir los mensajes si elimina la variable de entorno o si la establece en 1 (uno).

Para escribir los errores en un archivo de registro, cree una variable de entorno denominada VSTO_LOGALERTS y establézcala en 1 (uno). Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office crea el archivo de registro en la carpeta que contiene el manifiesto de implementación del complemento o, si genera un error, en la carpeta %TEMP% local. El nombre predeterminado es nombre de complemento.vsto.log. Para detener el registro de errores, elimine la variable de entorno o establézcala en 0 (cero).

Vea también

Tareas

Cómo: Volver a habilitar un complemento que se ha deshabilitado

Cómo: Controlar errores en proyectos de Office

Otros recursos

Generar y depurar soluciones de Office

Programar complementos de nivel de aplicación

Historial de cambios