Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 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 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 huella pequeña en comparación con los complementos y soluciones de VSTO, y puede compilarles mediante casi cualquier tecnología 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 VSTO, se inicia un nuevo proceso para la aplicación de Office objetivo y se carga el complemento VSTO.
Al iniciar la depuración de un proyecto de nivel de documento, el documento o libro de trabajo se abre en una nueva instancia de Word o Excel.
Al detener el depurador, este finaliza el proceso de la aplicación abruptamente o se desacopla si tiene el depurador configurado para desacoplarse. Todos los demás documentos que se abren en el proceso de aplicación de Office terminado también se cierran sin advertencia y se pierden los cambios no guardados. Esto puede incluir todos los documentos o hojas de cálculo que son abiertos mientras se ejecuta el depurador.
Normalmente, es mejor desvincularse del proceso antes de detener el depurador, para que pueda cerrar la aplicación de Office de forma habitual. También puede desvincularse del proceso primero si desea trabajar con el documento o la hoja de cálculo abiertos después de detener el depurador.
Si está depurando una personalización de nivel de documento para Word, detener el depurador repetidamente y hacer que Word se cierre repentinamente puede provocar que la plantilla Normal se corrompa. Si esto sucede, puede eliminar la plantilla Normal dañada y se volverá a crear automáticamente la próxima vez que abra Word. Sin embargo, las macros almacenadas en la plantilla Normal no se vuelven a crear.
Depurar complementos de VSTO de Office 2013 mediante 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 mediante una versión diferente de Office (2013 o 2016), abra el Diseñador de proyectos y, en la pestaña Depurar , elija el botón iniciar programa externo . A continuación, vaya a la ubicación del ejecutable de la aplicación de Office correspondiente.
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 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 a la forma en que el código administrado interactúa con 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, la aplicación de Microsoft Office continúa sin mostrar un error. Para ver estos errores, establezca el depurador para interrumpir las excepciones de Common Language Runtime. Para obtener más información, consulte Gestión de excepciones con el depurador.
Si configura el depurador para detenerse en excepciones del Common Language Runtime, todas las excepciones se detendrán ahora en el depurador, incluidas las que ha gestionado y algunas excepciones de primera oportunidad del propio tiempo de ejecución, que podrían no ser relevantes para tu proyecto. Los errores que hacen referencia a msosec que no se encuentran aparecen en todos los proyectos, pero se pueden ignorar con seguridad. Estas excepciones msosec no afectarán tu solución.
También puede hacer uso de Try...Catch statements alrededor de sus métodos para capturar excepciones.
De forma predeterminada, Visual Studio tampoco muestra los errores de depuración Just-In-Time para proyectos de Office; sin embargo, puede habilitar esta función para que pueda ver los errores que se generan. 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 bajo control de código fuente. Los proyectos de Visual Basic y C# almacenan las propiedades de depuración en un archivo específico del usuario (ProjectName.vbproj.user o ProjectName.csproj.user) y este archivo no está bajo control de código fuente. Si hay más de una persona depurando, cada persona debe introducir las propiedades de depuración manualmente.
Depuración de conjuntos de datos almacenados en caché en un proyecto de nivel de documento
Cada vez que construye un proyecto, el conjunto de datos se vacía y se recrea. Si desea depurar un conjunto de datos almacenado en caché, debe abrir el documento fuera de Visual Studio y, a continuación, adjuntar el depurador.
Depuración de proyectos de documentos de Microsoft Word basados en el formato de documento 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 complementos de VSTO que se comportan de forma inesperada. Una aplicación de Microsoft Office deshabilita los complementos de VSTO para evitar que el código problemático se cargue cada vez que se inicie la aplicación. Sin embargo, también es fácil causar 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.
Hay dos tipos de deshabilitación que las aplicaciones de Microsoft Office usan para los complementos de VSTO: deshabilitación completa y deshabilitación parcial.
Desactivación definitiva
La desactivación forzosa puede producirse cuando un complemento VSTO provoca que la aplicación se cierre inesperadamente. También podría ocurrir en su equipo de desarrollo si interrumpe el depurador mientras se está ejecutando el controlador de eventos en el complemento VSTO Startup. 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 deshabilita de forma difícil un complemento de VSTO creado mediante las herramientas de desarrollo de Office en Visual Studio, la aplicación deshabilita solo el complemento VSTO que provocó el error. Otros complementos VSTO creados con herramientas de desarrollo de Office en Visual Studio para la aplicación de Office correspondiente seguirán cargando.
Desactivación suave
La deshabilitación temporal 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 temporalmente un complemento de VSTO si produce una excepción no controlada mientras se ejecuta el Startup controlador de eventos. Cuando un complemento de VSTO está deshabilitado temporalmente, aparece en la lista de Complementos de Aplicación Inactivos, y la aplicación cambia el valor de la entrada del Registro LoadBehavior para el complemento VSTO, indicando que está descargado. 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 usar estos mensajes para resolver problemas de instalación e implementación.
Solucionar errores de inicio usando un archivo de registro de eventos y mensajes de error
El runtime 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. Puede activar las opciones mediante la creación de 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 eliminando la variable de entorno o estableciendolos 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 (una). 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 local%TEMP% . En el caso de los complementos de VSTO de nivel de aplicación, el nombre predeterminado es el nombre del complemento.vsto.log. Para los proyectos de nivel de documento, el nombre del archivo de registro es el 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).