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