Отладка в проектах на уровне приложения
Обновлен: Ноябрь 2007
Применимость |
|---|
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта
Версия Microsoft Office
Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов. |
Отладку проектов уровня приложения можно выполнить, используя те же инструменты Microsoft Visual Studio, которые используются для других проектов Visual Studio. Возможности отладчика Visual Studio, такие, как возможность вставлять точки останова и просматривать переменные в окне Локальные также доступны во время отладки проектов на уровне приложения. Дополнительные сведения об инструментах отладки Visual Studio см. в разделе Отладка в Visual Studio. Дополнительные сведения о проектах на уровне приложений см. в разделе Архитектура надстроек уровня приложения.
Запуск и остановка отладчика
Начать отладку проекта уровня приложения можно аналогично отладке других проектов Visual Studio. Например, можно нажать кнопку F5. При запуске отладки проекта запускается новый процесс для целевого приложения Office и загружается надстройка. Во время остановки отладчик внезапно завершает процесс приложения или отсоединяется, если задано отсоединение отладчика. Дополнительные сведения см. в разделе Сочетания клавиш отладки, схема Brief.
Отображение исключений
Если надстройка, созданная с использованием Visual Studio Tools for Office, выдает исключение, приложение Microsoft Office продолжает работу без отображения исключения. Задает отладчик для прерывания работы всех исключений, чтобы посмотреть, когда выдаются исключения надстроек. Дополнительные сведения см. в разделе Практическое руководство. Обработка ошибок в проектах Office.
Также инструкции Try...Catch можно вставить вокруг кода, который может выдавать исключение. Дополнительные сведения о том, как использовать инструкции Try...Catch см. в разделах Практическое руководство. Проверка кода с помощью блока Try… Catch в Visual Basic и Практическое руководство. Обработка исключений с помощью блока try-catch (Руководство по программированию на C#).
Отладка отключенных надстроек
Приложения Microsoft Office могут отключать надстройки, которые повели себя не так, как ожидалось во время загрузки. Приложение Microsoft Office отключает надстройки для предотвращения загрузки проблематичного кода при запуске приложения. Однако, во время обычной отладки легко вызвать неожиданное поведение. Сведения о повторном включении надстроек см. в разделе Практическое руководство. Повторное включение надстройки, которая была отключена.
Существуют два типа отключения, которые приложения Microsoft Office используют для надстроек: жесткая отмена и мягкая отмена.
Жесткая отмена
Жесткая отмена происходит, когда код, запускающийся во время загрузки надстройки, приводит к непредвиденному завершению работы приложения или во время остановки отладчика при выполнении конструктора или обработчика событий Startup.
Если в приложении Microsoft Office 2003 выполняется жесткая отмена надстройки, созданной с использованием Visual Studio Tools for Office, то вместе с надстройкой отменяется и файл AddinLoader.dll. AddinLoader.dll используется для загрузки надстроек, созданных с использованием Visual Studio Tools for Office. В результате для всех надстроек для данного приложения Microsoft Office, созданных с применением Visual Studio Tools for Office, запрещена загрузка для текущего пользователя. Дополнительные сведения о файле AddinLoader.dll см. в разделе Архитектура надстроек уровня приложения.
Если в приложении выпуска 2007 системы Microsoft Office выполняется жесткая отмена надстройки, созданной с использованием Visual Studio Tools for Office, то отменяется только надстройка, вызвавшая сбой. В результате другие надстройки для данного приложения Office 2007, созданные с использованием Visual Studio Tools for Office, будут продолжать загружаться.
Мягкая отмена
Мягкая отмена происходит, когда надстройка выдает необработанное исключение в конструкторе или обработчике событий Startup и не производится непредвиденное завершение работы приложения Microsoft Office. Приложение может отключить загрузку текущей надстройки для текущего пользователя. Когда приложение производит мягкую отмену надстройки, оно задает значение записи реестра LoadBehavior равное 2. Элемент LoadBehavior располагается в следующем разделе реестра: HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<имя приложения>\Addins\<имя надстройки>. Дополнительные сведения см. в разделе Записи реестра для надстроек уровня приложения.
Диагностика надстроек с использованием файла журнала и сообщений об ошибках
Среда выполнения Visual Studio Tools for Office может записывать все ошибки, происходящие во время запуска, в файл журнала или отображать каждую ошибку в диалоговом окне. По умолчанию эти параметры отключены. Параметры можно включить путем создания переменных среды.
Для отображения каждой ошибки в диалоговом окне создайте переменную среды под названием VSTO_SUPPRESSDISPLAYALERTS и установите ее значение равным 0 (нуль). Сообщения можно скрыть путем удаления переменной среды или задать ее значение равным 1 (единица).
Для записи ошибок в файл журнала создайте переменную среды под названием VSTO_LOGALERTS и установите ее значение равным 1 (единица). Среда выполнения Visual Studio Tools for Office создает файл журнала в папке, содержащей манифест приложения. Имя по умолчанию <Manifestname>.manifest.log. Чтобы остановить ведение журнала ошибок удалите переменную среды или установите ее значение равным 0 (нуль).
См. также
Задачи
Практическое руководство. Повторное включение надстройки, которая была отключена
Практическое руководство. Обработка ошибок в проектах Office
Основные понятия
Программирование надстроек уровня приложения