Depurar proyectos de nivel de documento

Puede utilizar las mismas herramientas de Visual Studio que se utilizan en otros proyectos para depurar los proyectos de nivel de documento de Microsoft Office Word y Microsoft Office Excel. Al ejecutar el proyecto en modo de depuración, Visual Studio inicia Word o Excel y el depurador se asocia a todo lo que se esté ejecutando en el mismo proceso con Word o Excel. Para obtener más información sobre las herramientas de depuración de Visual Studio, vea Depurar en Visual Studio.

Sugerencia
Cierre todas las instancias abiertas de Word o de Excel antes de iniciar el proceso de generación y depuración para evitar conflictos.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento para las siguientes aplicaciones: Excel 2007 y Excel 2010; Word 2007 y Word 2010. 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?.

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#. Para obtener más información, vea Debugging Shortcut Keys, Brief Scheme.

Detención del depurador

Cuando se empieza a depurar un documento o un libro, éste se abre en un nuevo proceso de Word o de Excel. Cuando el depurador se detiene, éste finaliza directamente el proceso de Word o Excel o se desasocia si el depurador está configurado para desasociar. Los restantes documentos o libros que están abiertos en un proceso de Word o de Excel que se termina también se cierran sin que el usuario reciba ningún tipo de aviso, y se pierden los cambios que no se han guardado previamente. En esta acción se pueden incluir todos los documentos o libros que están abiertos mientras se ejecuta el depurador.

Por lo general, conviene desasociarse del proceso antes de detener el depurador, para así poder salir de Word y Excel de la manera normal. También puede desasociarse del proceso primero si todavía funciona en una hoja de cálculo o documento abierto 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.

Durante las sesiones de depuración intensa, detener repetidamente el depurador y hacer que Word se cierre 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.

Word bloquea la plantilla Normal mientras está abierto en Visual Studio

Cuando Word está abierto en Visual Studio, bloquea la plantilla Normal predeterminada. El ejecutar su solución para depurarla, se abre otra copia de Word en otro proceso. Si realiza personalizaciones en el nivel de aplicación en la copia abierta de Word, no podrá guardar esos cambios porque la plantilla Normal estará bloqueada por el proceso abierto dentro de Visual Studio.

En tiempo de ejecución, Word abre instancias independientes de documentos en un único proceso, por lo que no es tan probable que un documento abierto bloquee la plantilla Normal e impida realizar cambios en el nivel de aplicación.

Para obtener más información, vea el artículo de Knowledge Base "PRB: Prompt to Save Normal.dot When Using Word as an Automation Server" (https://support.microsoft.com/default.aspx?scid=kb;es-es;285885).

Depurar conjuntos de datos almacenados en caché

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.

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 específico para cada usuario (<nombreDeProyecto>.vbproj.user o <nombreDeProyecto>.csproj.user) y este archivo no está sometido al control de código fuente. Si hay varias personas depurando, cada una de ellas debe introducir las propiedades de depuración manualmente.

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.

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 documento o libro que está asociado a la personalización o, si genera un error, en la carpeta %TEMP% local. El nombre del archivo de registro es nombre de 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: Controlar errores en proyectos de Office

Conceptos

Información general acerca del proceso de compilación de soluciones de Office

Otros recursos

Depurar en Visual Studio

Implementar soluciones de Office

Diseñar y crear soluciones de Office

Generar y depurar soluciones de Office

Historial de cambios

Fecha	Historial	Motivo
Septiembre de 2010	Se ha agregado una sección sobre la solución de problemas de errores de instalación de mediante el Visor de eventos.	Mejora de la información.
Mayo de 2010	Se han corregido algunos detalles sobre el registro de errores.	Corrección de errores de contenido.