Depurar proyectos de nivel de documento

Actualización: noviembre 2007

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.

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 Teclas de método abreviado para la depuración, esquema breve.

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. Es conveniente desasociarse del proceso antes de detener el depurador, para así poder salir de Word y Excel de la manera normal.

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.dot. Si esto ocurre, es necesario eliminar la plantilla Normal.dot dañada y ésta se volverá a crear automáticamente la siguiente vez que se abra Word. Sin embargo, las macros almacenadas en la plantilla Normal.dot anterior no volverán a crearse.

Si desea detener el depurador pero continuar trabajando en un documento o en una hoja de cálculo que estén abiertos, desasocie primero el depurador del proceso y, a continuación, detenga dicho depurador. Para obtener más información, vea Cómo: Desasociar todos los procesos.

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

Cuando Word está abierto en Visual Studio, bloquea la plantilla predeterminada Normal.dot. El ejecutar su solución para depurarla, se abre otra copia de Word en otro proceso. Si se realizan personalizaciones en el nivel de aplicación en la copia abierta de Word, como modificaciones en las barras de herramientas o en los menús, no será posible guardar esos cambios porque Normal.dot estará bloqueada por el proceso abierto dentro de Visual Studio.

En tiempo de ejecución, Word abre instancias independientes de los documentos en un único proceso, por lo que no es tan probable que un documento abierto bloquee Normal.dot 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 Word 2007 basados en el formato Documento de Word 97-2003 (* .doc)

Para depurar un proyecto de un documento de Word 2007 basado en el formato Documento de Word 97-2003 (* .doc), debe 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 (2007 System).

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.

Solucionar problemas utilizando un archivo de registro y mensajes de error

Visual Studio Tools para Office puede escribir todos los errores en un archivo de registro. De forma predeterminada, esta opción está desactivada para los proyectos de Word y Excel. Para activar esta opción, agregue la variable de entorno VSTO_LOGALERTS y establezca el valor en 1 (uno). Visual Studio Tools para Office crea el archivo de registro en la carpeta de resultados en la que se crea el documento de la solución o, si no se puede ahí, en la carpeta %TEMP%. El nombre predeterminado del archivo de registro es <nombreDeDocumento>.doc.log para Word y <nombreDeDocumento>.xls.log para Excel. Puede detener el registro de errores estableciendo la variable en 0 (cero).

Visual Studio Tools para Office muestra cada error en un cuadro de mensaje de forma predeterminada para los proyectos de Word y Excel. Puede hacer que Visual Studio Tools para Office deje de mostrar mensajes de error agregando la variable de entorno VSTO_SUPPRESSDISPLAYALERTS y estableciendo el valor en 1 (uno). Para mostrar mensajes de error, establezca la variable en 0 (cero).

Para obtener información sobre cómo establecer variables de entorno en Microsoft Windows XP, vea "Cómo administrar variables de entorno en Windows XP" (https://support.microsoft.com/default.aspx?scid=kb;es-es;310519).

Vea también

Tareas

Cómo: Controlar errores en proyectos de Office

Conceptos

Implementar soluciones de Office (2003 System)

Implementar soluciones de Office (2007 System)

Crear soluciones de Office en Visual Studio

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

Otros recursos

Depurar en Visual Studio

Generar y depurar soluciones de Office