Depurar proyectos de Office

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

Sugerencia
Para simplificar la depuración, cierre las instancias abiertas de la aplicación de Office antes de compilarla y depure.

Se aplica a: La información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Office 2013 y Office 2010. 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 Office igual que inicia la depuración de otros proyectos Visual Studio ; por ejemplo, puede presionar la tecla F5.Al iniciar la depuración de un proyecto de complemento de nivel de aplicación, un nuevo proceso para la aplicación de Office de destino se inicia y se carga el complemento.Al iniciar la depuración de un proyecto de nivel de documento, el documento o el libro en un nuevo proceso de word o excel.

Cuando el depurador se detiene, éste finaliza repentinamente el proceso de la aplicación o se desasocia si el depurador está configurado para desasociar.Se pierden el resto de los documentos que se abren en el proceso de la aplicación de Office finalizado también se cierran sin advertencia, y los cambios no guardados.En esta acción se pueden incluir todos los documentos o libros que están abiertos mientras se ejecuta el depurador.

Normalmente, conviene desasociarse del proceso antes de detener el depurador, para poder cerrar la aplicación de Office de la manera normal.También puede desasociarse del proceso primero si todavía desea ejecutar un documento o una hoja de cálculo después de detener el depurador.Para obtener más información sobre la desasociación de procesos, vea Cómo: Desasociar todos los procesos.

Si está depurando una personalización de nivel de documento para word, detener repetidamente el depurador y la palabra ceder para cerrar repentinamente puede provocar que se dañe la plantilla normal.Si esto ocurre, puede eliminar la plantilla Normal dañada y ésta se volverá a crear automáticamente la siguiente vez que abra Word.Sin embargo, las macros almacenadas en la plantilla Normal no volverán a crearse.

Comportamiento de F10 y F11

Al iniciar la depuración de un proyecto de Office, las teclas F10 y F11 no tienen el mismo comportamiento que cuando se inicia la depuración de otros proyectos de Visual Basic o C#.En los proyectos de Visual Basic o C#, el depurador se detiene en la función principal mientras que, en los proyectos de Office, Visual Studio no ejerce control sobre la función principal de la aplicación de Office.Sin embargo, durante la depuración, las teclas F10 y F11 sí tienen las mismas funciones que en los proyectos de Visual Basic y C#.

Mostrar excepciones

Debido a la forma en que el código administrado interactúa con el código no administrado, Visual Studio no presenta los errores generados por las aplicaciones de Microsoft Office.Por ejemplo, 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 un error.Para ver estos errores, configure el depurador para que se interrumpa al producirse excepciones de Common Language Runtime.Para obtener más información, vea Cómo: Interrumpir cuando se produce una excepción.

Si establece el depurador para interrumpir en excepciones de Common Language Runtime, ahora todas las excepciones penetra en el depurador, incluidas las que ha administrado y algunas excepciones en tiempo de ejecución del propio primero- probabilidades, que podría no ser pertinente para el proyecto.En todos los proyectos aparecen errores relacionados con el hecho de no encontrar msosec, pero se pueden omitir sin problema.Estas excepciones de msosec no afectarán a la solución.

También puede utilizar instrucciones Try...Catch en torno a sus métodos para detectar excepciones.

De forma predeterminada, Visual Studio tampoco muestra errores de depuración Just-In-Time de los proyectos de Office; sin embargo, es posible habilitar esta característica para poder ver los errores que se producen.Para obtener más información, vea Depuración Just-In-Time.

Argumentos de la línea de comandos

Si la Acción de inicio en la página de propiedades de Depurar se establece en Iniciar proyecto, Visual Studio no utiliza argumentos de la línea de comandos al depurar el proyecto, ni aunque se hayan especificado argumentos de este tipo como opciones de inicio.Si desea utilizar argumentos de la línea de comandos cuando inicia la depuración, debe seleccionar una Acción de inicio distinta de Iniciar proyecto.

Control de código fuente

Las propiedades de depuración no se comparten entre los distintos usuarios mediante el control de código fuente.Los proyectos de Visual Basic y C# almacenan las propiedades de depuración en un archivo usuario- específico (ProjectName.vbproj.user o .csproj.user ProjectName), y este archivo no está bajo control de código fuente.Si hay varias personas depurando, cada una de ellas debe introducir las propiedades de depuración manualmente.

Depurar conjuntos de datos almacenados en caché en un proyecto de nivel de documento

Cada vez que se genera un proyecto, se vacía el conjunto de datos y se vuelve a crear.Si desea depurar un conjunto de datos almacenado en caché, deberá abrir el documento desde fuera de Visual Studio y asociar después el depurador.

Depurar proyectos de documento de Word basados en el formato de documento (*.doc) de Word 97-2003

Para depurar un proyecto de documento de Word basado en el formato de documento (*.doc) de Word 97-2003, tiene que agregar la carpeta de proyecto a la lista de carpetas de confianza.Para obtener más información sobre cómo hacerlo, vea Otorgar confianza a los documentos.

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

Runtime 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.

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

Runtime 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).Runtime 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 en la carpeta que contiene el documento o libro que está asociado a la personalización.Si se produce un error, Runtime de Microsoft Visual Studio Tools para Office crea el archivo de registro en la carpeta %TEMP% local.Para agregar-INS en la aplicación, el nombre predeterminado es nombre del complemento.vsto.log.Para los proyectos de nivel de documento, el nombre del archivo de registro es nombre del documento.extensión.log, como ExcelWorkbook1.xlsx.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

Otros recursos

Compilar soluciones de Office

Programar complementos de nivel de aplicación