Отладка проектов Office
Вы можете отлаживать проекты Office, используя те же средства Microsoft Visual Studio, которые вы используете для других проектов Visual Studio. Функции отладчика Visual Studio, такие как возможность вставки точек останова и просмотра переменных в окне "Локальные" также доступны при отладке проектов Office. Дополнительные сведения о средствах отладки Visual Studio см. в разделе "Отладка" в Visual Studio.
Совет
Чтобы упростить процесс отладки, перед выполнением сборки и отладки закройте все открытые экземпляры приложения Office.
Область применения. Сведения в этом разделе относятся к проектам уровня документа и проектам надстроек VSTO. См. сведения о функциях, доступных по Приложение Office и типу проекта.
Примечание.
Заинтересованы в разработке решений, которые расширяют возможности Office на нескольких платформах? Ознакомьтесь с новой моделью надстроек Office. Надстройки Office имеют небольшое пространство по сравнению с надстройками и решениями VSTO, и вы можете создавать их практически с помощью любой технологии веб-программирования, таких как HTML5, JavaScript, CSS3 и XML.
Запуск и остановка отладчика
Вы можете начать отладку проекта Office так же, как и начать отладку других проектов Visual Studio; Например, можно нажать клавишу F5 . При запуске отладки проекта надстройки VSTO запускается новый процесс для целевой Приложение Office ликации, а надстройка VSTO загружается.
Если отладка запускается для проекта уровня документа, документ или книга открывается в новом процессе Word или Excel.
Если отладчик останавливается, он обрывает процесс приложения или отсоединяется (если отладчик настроен на отсоединение). Все остальные документы, открытые в прерываемом процессе приложения Office, также закрываются без предупреждения, а все несохраненные изменения теряются. Это относится ко всем документам или книгам, открытым во время работы отладчика.
Как правило, лучше отсоединить отладчик от процесса перед его остановкой и выйти из приложения Office обычным способом. Предварительное отсоединение от процесса рекомендуется также в том случае, если вы хотите продолжить работу с открытым документом или книгой после остановки отладчика.
При отладке настройки уровня документа для Word многократная остановка отладчика и связанное с ней непредвиденное завершение программы могут привести к повреждению шаблона Normal. В этом случае поврежденный шаблон Normal можно удалить — он будет создан автоматически, как только вы снова откроете приложение Word. При этом макросы, сохраненные в шаблоне Word, не воссоздаются.
Отладка надстроек VSTO для Office 2013 с помощью Office 2013 или Office 2016
Если вы используете Visual Studio 2015, и у вас установлены обе версии Office параллельно, Visual Studio запускает Office 2016. Если вы используете Visual Studio 2013, Visual Studio запускает Office 2013.
Если отладку надстройки VSTO необходимо выполнить с использованием другой версии Office (2013 или 2016), откройте конструктор проектов, перейдите на вкладку Отладка и установите переключатель Запуск внешней программы . Затем укажите расположение соответствующего исполняемого файла приложения Office.
Поведение F10 и F11
При запуске отладки проекта Office F10 и F11 не имеют того же поведения, что и при запуске отладки других проектов Visual Basic или C#. В проектах Visual Basic или C# отладчик останавливается на основной функции, а в случае проектов Office Visual Studio не имеет контроля над основной функции приложения Office. Однако во время отладки F10 и F11 имеют те же функции, что и в проектах Visual Basic и C#.
Отображение исключений
В связи с особым взаимодействием между управляемым и неуправляемым кодом Visual Studio не отображает ошибки, которые выдают приложения Microsoft Office. Например, если надстройка VSTO, созданная с помощью средств разработки Office в Visual Studio, создает исключение, microsoft Приложение Office lication продолжается без отображения ошибки. Для просмотра этих ошибок настройте отладчик на прерывание в случае исключений среды выполнения. Дополнительные сведения см. в разделе "Управление исключениями с помощью отладчика".
Если отладчик настроен на прерывание в случае исключений среды выполнения, все исключения вызывают остановку отладчика, включая обработанные исключения и некоторые исключения первого шанса, которые возникли в самой среде выполнения и могут не иметь отношения к вашему проекту. Ошибки, связанные с невозможностью обнаружения файла msosec, возникают в любом проекте и не требуют внимания. Исключения msosec никак не влияют на ваше решение.
Для перехвата исключений можно также использовать добавлять к методам операторы Try...Catch .
По умолчанию Visual Studio не отображает ошибки JIT-отладки для проектов Office, но эту функцию можно включить, чтобы видеть возникающие ошибки. Дополнительные сведения см. в статье "JIT-отладка" в Visual Studio.
Аргументы командной строки
Если для начального действия на странице свойств отладки задано значение Start Project, Visual Studio не использует аргументы командной строки при отладке проекта, даже если в качестве параметров запуска заданы аргументы командной строки. Если вы хотите использовать аргументы командной строки при запуске отладки, необходимо выбрать действие "Пуск", отличное от запуска проекта.
Управление исходным кодом
Отладка свойств не выполняется для всех пользователей, зарегистрированных в системе контроля версий, одновременно. Проекты Visual Basic и C# сохраняют свойства отладки в файлы конкретных пользователей (имя_проекта.vbproj.user или имя_проекта.csproj.user), не входящие в систему управления версиями. Если отладку выполняют сразу несколько пользователей, каждый из них вводит свойства отладки вручную.
Отладка кэшированных наборов данных в проекте уровня документа
При каждой сборке проекта набор данных опустошается и создается заново. Чтобы отладить кэшированный набор данных, откройте документ вне Visual Studio, а затем присоедините отладчик.
Отладка проектов документов Word на основе формата документа Word 97-2003 (*.doc)
Чтобы выполнить отладку проекта Документа Word на основе формата Документа Word 97-2003 (/DOC*), необходимо добавить папку проекта в список доверенных папок. Дополнительные сведения о том, как это сделать, см. в разделе "Предоставление доверия документам".
Отладка отключенных надстроек
Приложения Microsoft Office могут отключать надстройки VSTO, которые ведут себя непредсказуемым образом. Это делается для того, чтобы предотвратить загрузку неисправного кода при каждом запуске приложения. В то же время, непредвиденное поведение может возникать и в процессе обычной отладки. Сведения о повторном включении надстроек VSTO см. в статье "Практическое руководство. Повторное включение надстройки VSTO, которая была отключена.
В приложениях Microsoft Office используются два вида отключения надстроек VSTO: жесткое и мягкое.
Жесткое отключение
Жесткое отключение может возникать, когда надстройка VSTO приводит к неожиданному закрытию приложения. На компьютере разработчика оно применяется также в случае остановки отладчика во время выполнения обработчика событий Startup в надстройке VSTO. Если надстройка VSTO отключена, она отображается в списке "Отключенные элементы " в приложении.
Если Приложение Office ликация жестко отключает надстройку VSTO, созданную с помощью средств разработки Office в Visual Studio, приложение отключает только надстройку VSTO, которая вызвала сбой. Другие надстройки VSTO, созданные с помощью средств разработки Office в Visual Studio для того же приложения Office, будут загружаться по-прежнему.
Обратимое отключение
Мягкое отключение применяется, если вызванная надстройкой VSTO ошибка не приводит к неожиданному завершению работы приложения. Надстройка VSTO отключается мягким способом, например, если выдает необработанное исключение во время выполнения обработчика событий Startup . Если надстройка VSTO отключена, она отображается в списке неактивных надстроек приложений в приложении, а приложение изменяет значение записи реестра LoadBehavior для надстройки VSTO, чтобы указать, что она выгружается. Дополнительные сведения о записи реестра LoadBehavior см . в разделах реестра надстроек VSTO.
Устранение ошибок установки с помощью Просмотр событий
Среда выполнения набор средств Visual Studio для Office записывает сообщения в Просмотр событий в Windows для всех исключений, которые возникают при установке или удалении решений Office. Эти сообщения можно использовать для решения проблем развертывания и установки.
Устранение ошибок запуска с помощью файла журнала и сообщений об ошибках
Среда выполнения набор средств Visual Studio для Office может записывать все ошибки, возникающие во время запуска в файл журнала или отображать каждую ошибку в окне сообщения. По умолчанию эти параметры отключены. Вы можете включить параметры, создав переменные среды.
Чтобы каждая ошибка отображалась в окне сообщения, создайте переменную среды с именем VSTO_SUPPRESSDISPLAYALERTS и присвойте ей значение 0 (ноль). Чтобы отключить отображение сообщений, удалите эту переменную среды или присвойте ей значение 1 (один).
Чтобы ошибки записывались в файл журнала, создайте переменную среды с именем VSTO_LOGALERTS и присвойте ей значение 1 (один). Среда выполнения набор средств Visual Studio для Office создает файл журнала в папке, содержащей манифест развертывания надстройки VSTO, или в папке, содержащей документ или книгу, связанную с настройкой. При сбое среда выполнения набор средств Visual Studio для Office создает файл журнала в локальной папке %TEMP% . Для надстроек VSTO уровня приложения файлу журнала по умолчанию присваивается имя имя_надстройки.vsto.log. Для проектов уровня документа файлу журнала присваивается имя имя_документа.extension.log, например ExcelWorkbook1.xlsx.log. Чтобы остановить ведение журнала ошибок, удалите переменную среды или присвойте ей значение 0 (ноль).