Depuración de proyectos de Office

  • Artículo

Puede depurar proyectos de Office 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 ver 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 todas las instancias abiertas de la aplicación de Office antes de compilarla y depurarla.

Se aplica a: la información de este tema se aplica a proyectos de nivel de documento y proyectos de complementos de VSTO. Consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

Nota:

¿Le interesa desarrollar soluciones que amplíen la experiencia de Office en varias plataformas? Consulte el nuevo modelo de complementos de Office. Los complementos de Office tienen una superficie pequeña en comparación con los complementos y soluciones de VSTO, y puede compilarlos mediante casi cualquier tecnología de programación web, como HTML5, JavaScript, CSS3 y XML.

Iniciar y detener el depurador

Puede iniciar la depuración de un proyecto de Office igual que para empezar a depurar otros proyectos de Visual Studio; por ejemplo, puede presionar la tecla F5 . Al iniciar la depuración de un proyecto de complemento de VSTO, se inicia un nuevo proceso para la aplicación de Office lication de destino y se carga el complemento de VSTO.

Al iniciar la depuración de un proyecto de nivel de documento, el documento o libro se abre en un nuevo proceso de Word o Excel.

Cuando se detiene el depurador, este finaliza el proceso de aplicación repentinamente o, si lo tiene configurado para desasociarse, el depurador se desasocia. También se cierran sin previo aviso todos los documentos que estuvieran abiertos en el proceso de aplicación de Office finalizado y se pierden los cambios no guardados. Esto puede incluir todos los documentos o libros que estén abiertos mientras se ejecuta el depurador.

Normalmente, antes de detener el depurador es mejor desasociarlo del proceso para poder salir de la aplicación de Office de la forma normal. También puede desasociarlo antes del proceso si desea seguir trabajando con un documento u hoja de cálculo abiertos después de detener al depurador.

Si está depurando una personalización de nivel de documento para Word, detener el depurador y hacer que Word se cierre repentinamente una y otra vez puede dañar la plantilla Normal. Si esto ocurre, puede eliminar la plantilla Normal dañada y ésta se volverá a crear automáticamente la próxima vez que abra Word. Sin embargo, las macros que se hayan almacenado en la plantilla Normal no se volverán a crear.

Depurar complementos de VSTO de Office 2013 con Office 2013 u Office 2016

Si usa Visual Studio 2015 y tiene ambas versiones de Office instaladas en paralelo, Visual Studio inicia Office 2016. Si usa Visual Studio 2013, Visual Studio inicia Office 2013.

Si desea depurar el complemento de VSTO empleando una versión diferente de Office (2013 o 2016), abra el Diseñador de proyectosy, en la ficha Depurar , elija el botón de opción Iniciar programa externo . A continuación, busque la ubicación del ejecutable de la aplicación de Office apropiada.

Comportamiento F10 y F11

Al iniciar la depuración de un proyecto de Office, F10 y F11 no tienen el mismo comportamiento que al iniciar 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; en los proyectos de Office, Visual Studio no tiene control sobre la función principal de la aplicación de Office. Sin embargo, durante la depuración, F10 y F11 tienen las mismas funciones que en los proyectos de Visual Basic y C#.

Mostrar excepciones

Debido al modo en que el código administrado interactúa con el código no administrado, Visual Studio no muestra los errores que producen las aplicaciones de Microsoft Office. Por ejemplo, si un complemento de VSTO creado mediante las herramientas de desarrollo de Office en Visual Studio produce una excepción, microsoft aplicación de Office lication continúa sin mostrar un error. Para ver estos errores, configure el depurador para que se interrumpa al aparecer excepciones de Common Language Runtime. Para obtener más información, consulte Administración de excepciones con el depurador.

Si configura el depurador para que se detenga al aparecer excepciones de Common Language Runtime, el depurador se interrumpirá con todas las excepciones, tanto las que se han controlado como algunas excepciones de primera oportunidad del tiempo de ejecución, que podrían no ser pertinentes para el proyecto. En todos los proyectos aparecen errores relacionados con msosec no encontrado, pero son seguros omitir. Las 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 de Just-In-Time para proyectos de Office. Sin embargo, puede habilitar esta característica para ver los errores que se produzcan. Para obtener más información, consulte Depuración Just-In-Time en Visual Studio.

Argumentos de la línea de comandos

Si la acción de inicio de la página de propiedades Depurar está establecida en Iniciar proyecto, Visual Studio no usa argumentos de línea de comandos al depurar el proyecto, aunque haya especificado argumentos de línea de comandos como opciones de inicio. Si desea usar argumentos de línea de comandos al iniciar la depuración, debe seleccionar una acción de inicio que no sea Iniciar proyecto.

Control de código fuente

Las propiedades de depuración no se comparten entre varios usuarios cuando se trabaja con control de código fuente. Los proyectos de Visual Basic y C# almacenan las propiedades de depuración en un archivo específico de cada usuario (NombredeProyecto.vbproj.user o NombredeProyecto.csproj.user), y este archivo no está bajo control de código fuente. Si hay más de una persona depurando, cada una debe introducir manualmente las propiedades de depuración.

Depuración de conjuntos de datos almacenados en caché en un proyecto de nivel de documento

Cada vez que se compila un proyecto, el conjunto de datos se vacía y se vuelve a crear. Si desea depurar un conjunto de datos en caché, debe abrir el documento fuera de Visual Studio y, a continuación, asociar el depurador.

Depuración de proyectos de documentos de Word basados en el formato documento de Word 97-2003 (*.doc)

Para depurar un proyecto de documento de Word basado en el formato documento de Word 97-2003 (/.doc*), debe agregar la carpeta del proyecto a la lista de carpetas de confianza. Para obtener más información sobre cómo hacerlo, consulte Concesión de confianza a documentos.

Depurar complementos deshabilitados

Las aplicaciones de Microsoft Office pueden deshabilitar los complementos de VSTO que se comporten de forma inesperada. La aplicación de Microsoft Office deshabilita los complementos de VSTO para evitar que se cargue código problemático cada vez que se inicie la aplicación. Sin embargo, esto también puede producir un comportamiento inesperado durante la depuración típica. Para obtener información sobre cómo volver a habilitar complementos de VSTO, consulte How to: Re-enable a VSTO Add-in that has been disabled.

Las aplicaciones de Microsoft Office usan dos tipos de deshabilitación para los complementos de VSTO: deshabilitación total y deshabilitación parcial.

Deshabilitación de forma difícil

La deshabilitación difícil puede producirse cuando un complemento VSTO hace que la aplicación se cierre inesperadamente. También puede ocurrir en el equipo de desarrollo si detiene el depurador mientras se está ejecutando el controlador de eventos Startup en el complemento de VSTO. Cuando un complemento de VSTO está deshabilitado de forma difícil, aparece en la lista Elementos deshabilitados de la aplicación.

Si una aplicación de Office lication deshabilita de forma dura un complemento de VSTO creado mediante herramientas de desarrollo de Office en Visual Studio, la aplicación deshabilita solo el complemento VSTO que provocó el error. Los demás complementos de VSTO creados con las herramientas de desarrollo de Office en Visual Studio para esa aplicación de Office continuarán cargándose.

Deshabilitación temporal

La deshabilitación parcial puede producirse cuando un complemento de VSTO genera un error que no hace que la aplicación se cierre inesperadamente. Por ejemplo, una aplicación podría deshabilitar parcialmente un complemento de VSTO si produce una excepción no controlada mientras se ejecuta el controlador de eventos Startup . Cuando un complemento de VSTO está deshabilitado temporalmente, aparece en la lista Complementos de aplicación inactivos de la aplicación y la aplicación cambia el valor de la entrada del Registro LoadBehavior para el complemento VSTO para indicar que se descarga. Para obtener más información sobre la entrada del Registro LoadBehavior , consulte Entradas del Registro para complementos de VSTO.

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

El entorno de ejecución de Visual Studio Tools para Office escribe mensajes en el Visor de eventos en Windows para todas las excepciones que se producen al instalar o desinstalar soluciones de Office. Puede utilizar estos mensajes para resolver problemas de implementación y de instalación.

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

El entorno 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. Estas opciones están desactivadas de forma predeterminada. Puede activar las opciones mediante la creación de variables de entorno.

Si desea mostrar cada error en un cuadro de mensaje, cree una variable de entorno denominada VSTO_SUPPRESSDISPLAYALERTS y establézcala en 0 (cero). Para suprimir los mensajes, puede eliminar la variable de entorno o establecerla en 1 (uno).

Si desea escribir los errores en un archivo de registro, cree una variable de entorno denominada VSTO_LOGALERTS y establézcala en 1 (uno). El entorno de ejecución de Visual Studio Tools para Office crea el archivo de registro en la carpeta que contiene el manifiesto de implementación para el complemento vsTO o en la carpeta que contiene el documento o libro asociado a la personalización. Si se produce un error, el entorno de ejecución de Visual Studio Tools para Office crea el archivo de registro en la carpeta %TEMP% local. Para complementos de VSTO de nivel de aplicación, el nombre predeterminado es nombre de complemento.vsto.log. Para los proyectos de nivel de documento, el nombre del archivo de registro es nombre de documento.extensión.log, por ejemplo, ExcelWorkbook1.xlsx.log. Para detener el registro de errores, elimine la variable de entorno o establézcala en 0 (cero).

Contenido relacionado