Отладка в проектах уровня документа
Обновлен: Ноябрь 2007
Применимость |
|---|
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта
Версия Microsoft Office
Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов. |
Отладка проектов уровня документа для Microsoft Office Word и Microsoft Office Excel выполняется с помощью тех же средств Visual Studio, что и для других проектов. При запуске проекта в режиме отладки среды Visual Studio автоматически запускается приложение Word или Excel. Ко всем компонентам, выполняемым в одном процессе с приложением Word или Excel, присоединяется отладчик. Дополнительные сведения о средствах отладки Visual Studio см. в разделе Отладка в Visual Studio.
.gif "Совет") Совет. |
|---|
Чтобы избежать конфликтов, перед построением и отладкой решения закройте все открытые экземпляры приложений Word и Excel. |
Использование клавиш F10 и F11
При запуске отладки проекта Office действие клавиш F10 и F11 отличается от их действия при запуске отладки проектов Visual Basic или C#. В проектах Visual Basic и C# отладчик останавливается на основной функции. В проектах Office управление основной функцией приложения Office с помощью средств Visual Studio недоступно. Однако в процессе отладки действие клавиш F10 и F11 аналогично проектам Visual Basic и C#. Дополнительные сведения см. в разделе Сочетания клавиш отладки, схема Brief.
Остановка отладчика
При запуске отладки документ или книга открываются в новом процессе приложения Word или Excel. При остановке отладчик внезапно завершает процесс приложения Word и Excel или отсоединяется, если задано отсоединение отладчика. Все документы или книги, открытые в завершаемом процессе приложения Word или Excel, также закрываются без предупреждения. В этом случае любые несохраненные изменения будут потеряны. Также закрываются все документы или книги, открытые во время выполнения отладчика. Перед остановкой отладчика рекомендуется отсоединять его от процесса, что позволяет завершить работу приложения Word или Excel обычным способом.
Если в процессе отладки несколько раз выполняется остановка отладчика с последующим внезапным закрытием приложения Word, это может привести к повреждению шаблона Normal.dot. В этом случае можно удалить поврежденный шаблон Normal.dot, чтобы автоматически восстановить его рабочую версию при следующем запуске приложения Word. Обратите внимание, что восстановление макросов, хранящихся в шаблоне Normal.dot, не выполняется.
Чтобы продолжить работу с документом или книгой после остановки отладчика, следует отсоединить отладчик от процесса перед его остановкой. Дополнительные сведения см. в разделе Практическое руководство. Окончательное удаление всех процессов.
Блокировка шаблона Normal.dot в приложении Word, открытом в среде Visual Studio
Используемый по умолчанию шаблон Normal.dot блокируется в приложении Word, открытом в среде Visual Studio. При запуске решения для отладки копия приложения Word открывается в отдельном процессе. Если настройка уровня приложения, например изменение панелей инструментов или меню, выполняется в открытой копии приложения Word, выполненные изменения не сохраняются в шаблоне Normal.dot, поскольку он заблокирован процессом, открытым в среде Visual Studio.
Во время выполнения экземпляры документов Word открываются в отдельных процессах, что позволяет избежать блокирования шаблона Normal.dot отдельным документом и обеспечивает сохранение изменений.
Дополнительные сведения см. в статье базы знаний "PRB. Запрос на сохранение шаблона Normal.dot при использовании приложения Word в качестве сервера автоматизации" (на английском языке) (https://support.microsoft.com/default.aspx?scid=kb;ru-ru;285885).
Отладка кэшированных наборов данных
При каждом построении проекта набор данных очищается и создается заново. Для отладки кэшированного набора данных следует открыть документ вне среды Visual Studio и затем присоединить к нему отладчик.
Отладка проектов Word 2007, построенных на базе документов Word 97-2003 в формате DOC
Чтобы выполнить отладку проекта документа Word 2007, построенного на базе документа Word 97-2003 в формате DOC, следует добавить папку проекта в список надежных папок. Дополнительные сведения см. в разделе Присвоение уровня доверия документам (система 2007).
Система управления версиями
В режиме управления версиями свойства отладки недоступны для совместного использования несколькими пользователями. Свойства отладки для проектов Visual Basic и C# хранятся в отдельном для каждого пользователя файле (<имя_проекта>.vbproj.user или <имя_проекта>.csproj.user), который недоступен в системе управления версиями. Каждый пользователь, выполняющий отладку, должен задавать свойства отладки вручную.
Аргументы командной строки
Если на странице свойств Отладка для свойства Действие при запуске установлено значение Запуск проекта, при отладке проекта в среде Visual Studio не используются аргументы командной строки (даже если они указаны в качестве параметров запуска). Чтобы использовать аргументы командной строки при запуске отладки, установите для свойства Действие при запуске значение, отличное от Запуск проекта.
Устранение неполадок с помощью файла журнала и сообщений об ошибках
В Visual Studio Tools for Office выполняется запись всех ошибок в файл журнала. По умолчанию для проектов Word и Excel этот параметр отключен. Чтобы включить этот параметр, добавьте переменную среды VSTO_LOGALERTS и установите для нее значение 1 (единица). Файл журнала создается в выходной папке Visual Studio Tools for Office, в которой создается документ решения, или в папке %TEMP%. По умолчанию файлу журнала присваивается имя <имя_документа>.doc.log (для Word) или <имя_документа>.xls.log (для Excel). Чтобы прекратить ведение журнала ошибок, установите для переменной значение 0 (нуль).
В Visual Studio Tools for Office все сообщения об ошибках в проектах Word и Excel по умолчанию отображаются в окне сообщений. Чтобы отключить отображение сообщений об ошибках в Visual Studio Tools for Office, добавьте переменную среды VSTO_SUPPRESSDISPLAYALERTS и установите для нее значение 1 (единица). Чтобы отображать сообщения об ошибках, установите для переменной значение 0 (нуль).
Дополнительные сведения об использовании переменных среды в Microsoft Windows XP см. в статье "Управление переменными среды в Microsoft Windows XP" (https://support.microsoft.com/default.aspx?scid=kb;ru-ru;310519).
См. также
Задачи
Практическое руководство. Обработка ошибок в проектах Office
Основные понятия
Развертывание решений Office (система 2003)
Развертывание решений Office (система 2007)
Создание решений Office в Visual Studio
Общие сведения о процессе построения решений Office