Отладка проектов Office

Отладка проектов office с помощью тех же средств Microsoft Visual Studio использовании для других проектов Visual Studio.Функции отладчика Visual Studio, такие как возможность вставки точки останова и просмотр переменных в окне Локальные, также доступны при отладке проектов office.Дополнительные сведения об инструментах отладки Visual Studio см. в разделе Отладка в Visual Studio.

Совет
Чтобы упростить отладку, закройте все открытые экземпляров приложения office перед построением и отладить его.

Применение. Сведения этого раздела применяются к проектам уровня документа и уровня приложения для Office 2013 и Office 2010. См. раздел Доступность функций по типам приложений Office и проектов.

Для просмотра связанных демонстрационных видеороликов перейдите по ссылке How Do I: Debug a VSTO Application ? (Инструкции: отладка приложения VSTO).

Запуск и остановка отладчика

Можно начать отладку проекта office точно так же, как начать отладку другие проекты Visual Studio; например, можно нажать клавишу F5 ключ.При запуске отладки проекта надстройки уровня приложения, запустить новый процесс для целевого приложения office и надстройка загружается.При запуске отладки проекта уровня документа документ или открытые книги в новом процессе слова или Excel.

Во время остановки отладчик внезапно завершает процесс приложения или отсоединяется, если задано отсоединение отладчика.Будут потеряны любые другие документы, которые открываются в завершенной обработке приложения office также закрыты без предупреждения и любых несохраненных изменений.Также закрываются все документы или книги, открытые во время выполнения отладчика.

Как правило, лучше наконец удалить из процесса до остановки отладчика, что позволяет выйти из приложения office обычным способом.Наконец, можно также удалить из процесса сначала если все еще требуется работать с открытым документом или листом после остановки отладчика.Дополнительные сведения об отсоединении отладчика от процесса см. в разделе Практическое руководство. Окончательное удаление всех процессов.

При отладке настройки уровня документа для слова, повторно остановки, отладчик и слово вызывать закрыть внезапно могут привести к обычный шаблону быть повреждены.В этом случае можно удалить поврежденный шаблон Normal, чтобы автоматически восстановить его рабочую версию при следующем запуске приложения Word.Обратите внимание, что восстановление макросов, хранящихся в шаблоне Normal, не выполняется.

Использование клавиш F10 и F11

При запуске отладки проекта Office действие клавиш F10 и F11 отличается от их действия при запуске отладки проектов Visual Basic или C#.В проектах Visual Basic и C# отладчик останавливается на основной функции. В проектах Office управление основной функцией приложения Office с помощью средств Visual Studio недоступно.Однако в процессе отладки действие клавиш F10 и F11 аналогично проектам Visual Basic и C#.

Отображение исключений

Из-за способа взаимодействия управляемого и неуправляемого кодов Visual Studio не отображает ошибки, возникающие в приложениях Microsoft Office.Например, если надстройка, созданной с помощью средств разработки office в Visual Studio создает исключение, то приложение Microsoft Office продолжается без отображения ошибки.Чтобы посмотреть эти ошибки, отладчик прерывает исключения общеязыковой среды выполнения.Дополнительные сведения см. в разделе Практическое руководство. Прерывание выполнения при создании исключения.

Если набор отладчик, который нужно прервать об исключениях среды CLR, все исключения теперь сломаете в отладчик, включая один, и некоторые исключения регулировали сами перв- вероятность из среды выполнения, которая может не быть относится к проекту.Ошибки, связанные с msosec, которые не были обнаружены, могут возникать в каждом проекте. Однако такие ошибки можно не учитывать.Исключения msosec не повлияют на решение.

В рамках определенных методов для перехвата исключений также можно использовать операторы Try...Catch.

По умолчанию Visual Studio не отображает ошибок JIT-отладки для проектов Office; однако с целью просмотра возникающих ошибок данную функцию можно активировать вручную.Дополнительные сведения см. в разделе JIT-отладка.

Аргументы командной строки

Если на странице свойств Отладка для свойства Действие при запуске установлено значение Запуск проекта, при отладке проекта в среде Visual Studio не используются аргументы командной строки (даже если они указаны в качестве параметров запуска).Чтобы использовать аргументы командной строки при запуске отладки, установите для свойства Действие при запуске значение, отличное от Запуск проекта.

Система управления версиями

В режиме управления версиями свойства отладки недоступны для совместного использования несколькими пользователями.Проекты Visual Basic и C# хранятся в файле пользователь- свойства отладки (ИмяПроекта.vbproj.user или ИмяПроекта.csproj.user), этот файл не находится под управлением системы управления версиями.Каждый пользователь, выполняющий отладку, должен задавать свойства отладки вручную.

Отладка кэшированных наборов данных в проекте уровня документа

При каждом построении проекта набор данных очищается и создается заново.Для отладки кэшированного набора данных следует открыть документ вне среды Visual Studio и затем присоединить к нему отладчик.

Отладка проектов документов Word, построенных на базе документов Word 97-2003 в формате DOC

Чтобы выполнить отладку проекта документа Word, построенного на базе документа Word 97-2003 в формате DOC, следует добавить папку проекта в список надежных папок.Дополнительные сведения см. в разделе Присвоение уровня доверия документам.

Отладка отключенных надстроек

В приложениях Microsoft Office можно отключить надстройки, поведение которых отличается от ожидаемого.Приложение Microsoft Office отключает надстройки для предотвращения загрузки проблематичного кода при запуске приложения.Однако, во время обычной отладки легко вызвать неожиданное поведение.Сведения о повторном включении надстроек см. в разделе Практическое руководство. Повторное включение надстройки, которая была отключена.

Существуют два типа отключения, которые приложения Microsoft Office используют для надстроек: жесткая отмена и мягкая отмена.

Жесткая отмена

Жесткая отмена может иметь место, если надстройка вызывает неожиданное завершение приложения.Кроме того, жесткая отмена может произойти на компьютере разработки, если остановить отладчик во время выполнения обработчика событий Startup в надстройке.В случае жесткой отмены надстройки эта надстройка отображается в списке Отключенные объекты приложения.

Если в приложении Office выполняется жесткая отмена надстройки, созданной с использованием средств разработки Office в Visual Studio, то отменяется только надстройка, вызвавшая сбой.Другие надстройки для данного приложения Office, созданные с использованием средств разработки Office в Visual Studio, будут продолжать загружаться.

Мягкая отмена

Мягкая отмена может иметь место, если надстройка создает ошибку, не вызывающую неожиданного закрытия приложения.Например, приложение может выполнить мягкую отмену надстройки, создающей необработанное исключение во время выполнения обработчика событий Startup.При мягкой отмене надстройки она отображается в списке Неактивные надстройки приложений соответствующего приложения и это приложение изменяет значение записи реестра LoadBehavior для данной надстройки, чтобы указать, что она разгружена.Дополнительные сведения о записи реестра LoadBehavior см. в разделе Записи реестра для надстроек уровня приложения.

Устранение проблем установки с помощью средства просмотра событий

Visual Studio Tools for Office (cреда выполнения) записывает сообщения обо всех исключениях, созданных при установке или удалении решений Office, в средство просмотра событий в Windows.С помощью этих сообщений можно устранить проблемы, возникающие в ходе установки и развертывания.

Диагностика ошибок запуска с использованием файла журнала и сообщений об ошибках

Среда выполнения Visual Studio Tools for Office (cреда выполнения) может записывать все ошибки, происходящие во время запуска, в файл журнала или отображать каждую ошибку в диалоговом окне.По умолчанию эти параметры отключены.Параметры можно включить путем создания переменных среды.

Для отображения каждой ошибки в диалоговом окне создайте переменную среды под названием VSTO_SUPPRESSDISPLAYALERTS и установите ее значение равным 0 (нуль).Сообщения можно скрыть путем удаления переменной среды или задать ее значение равным 1 (единица).

Для записи ошибок в файл журнала создайте переменную среды под названием VSTO_LOGALERTS и установите ее значение равным 1 (единица).Visual Studio Tools for Office (cреда выполнения) создает файл журнала в папке, содержащей манифест развертывания для надстройки или в папку, которая содержит документ или книга, которые сопоставлены с настройкой.Если это не удается, Visual Studio Tools for Office (cреда выполнения) создает файл журнала в локальной папке %TEMP%.Для добавить-ins уровня приложения, имя по умолчанию имя надстройки.vsto.log.Для проектов уровня документа, имя файла журнала имя документа.расширение.log, например ExcelWorkbook1.xlsx.log.Чтобы остановить ведение журнала ошибок удалите переменную среды или установите ее значение равным 0 (нуль).

См. также

Задачи

Практическое руководство. Повторное включение надстройки, которая была отключена

Другие ресурсы

Построение решений Office

Программирование надстроек уровня приложения