Depurar proyectos de nivel de aplicación
Actualización: noviembre 2007
Se aplica a |
|---|
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto
Versión de Microsoft Office
Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto. |
Puede depurar proyectos de nivel de aplicación si utiliza las mismas herramientas de Microsoft Visual Studio que utiliza para otros proyectos de Visual Studio. Las características del depurador de Visual Studio, como la capacidad de insertar puntos de interrupción y variables de vista 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.
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 Teclas de método abreviado para la depuración, esquema breve.
Mostrar excepciones
Si un complemento creado con Visual Studio Tools para Office 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 cuando se están cargando. 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 produce cuando el código que se ejecuta al cargar el complemento hace que la aplicación se cierre inesperadamente o cuando se detiene el depurador mientras el constructor o el controlador de eventos Startup se están ejecutando.
Si una aplicación de Microsoft Office 2003 deshabilita de forma completa un complemento creado con Visual Studio Tools para Office, la aplicación deshabilita tanto el complemento como AddinLoader.dll. AddinLoader.dll se utiliza para cargar complementos creados mediante Visual Studio Tools para Office. Como resultado, se impide que se carguen para el usuario actual todos los complementos creados con Visual Studio Tools para Office para esa aplicación de Microsoft Office. Para obtener más información sobre AddinLoader.dll, vea Arquitectura de los complementos de nivel de aplicación.
Si una aplicación de 2007 Microsoft Office system deshabilita de forma completa un complemento creado con Visual Studio Tools para Office, la aplicación deshabilita únicamente el complemento que causó el error. Como resultado, se seguirán cargando otros complementos creados con Visual Studio Tools para Office para esa aplicación de Office 2007.
Deshabilitación parcial
La deshabilitación parcial se produce cuando un complemento genera una excepción no controlada en el constructor o el controlador del evento Startup, pero la aplicación de Microsoft Office no se cierra inesperadamente. La aplicación podría evitar únicamente que se cargue el complemento actual para el usuario actual. Cuando una aplicación deshabilita de forma parcial un complemento, establece el valor de la entrada del Registro LoadBehavior para el complemento en 2. La entrada LoadBehavior se encuentra bajo la siguiente clave del Registro: HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<nombre de la aplicación>\Addins\<nombre del complemento>. Para obtener más información sobre esta clave del Registro, vea Entradas del Registro de complementos de nivel de aplicación.
Solucionar problemas de complementos mediante archivos de registro y mensajes de error
El motor en tiempo de ejecución de 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). El motor en tiempo de ejecución de Visual Studio Tools para Office crea el archivo de registro en la carpeta que contiene el manifiesto de aplicación. El nombre predeterminado es <nombreDeManifiesto>.manifest.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
Conceptos
Programar complementos de nivel de aplicación