Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Вы можете отлаживать проекты 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, повторные остановки отладчика и внезапное закрытие Word могут привести к повреждению шаблона "Обычный". Если это произойдет, вы можете удалить поврежденный шаблон Normal, и он будет автоматически создан при следующем открытии Word. Однако все макросы, хранящиеся в шаблоне "Обычный", не создаются повторно.
Отладка надстроек OFFICE 2013 VSTO с помощью 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 продолжается без отображения ошибки. Чтобы увидеть эти ошибки, задайте отладчику прервать исключения среды CLR. Дополнительные сведения см. в разделе "Управление исключениями с помощью отладчика".
Если вы настроите отладчик на остановку при общих исключениях среды CLR, теперь все исключения будут обрабатываться отладчиком, включая те, которые вы обработали, и некоторые исключения первого уровня из самой среды выполнения, которые могут не иметь отношения к вашему проекту. Ошибки, ссылающиеся на msosec, не обнаруживаются в каждом проекте, но не могут игнорироваться. Эти исключения MSOSEC не повлияют на ваше решение.
Вы также можете использовать операторы Try...Catch вокруг ваших методов, чтобы перехватывать исключения.
По умолчанию Visual Studio не отображает ошибки отладки Just-In-Time для проектов Office; однако эту функцию можно включить, чтобы вы могли видеть вызываемые ошибки. Дополнительные сведения см. в статье Just-In-Time отладка в Visual Studio.
Аргументы командной строки
Если для начального действия на странице свойств отладки задано значение Start Project, Visual Studio не использует аргументы командной строки при отладке проекта, даже если в качестве параметров запуска заданы аргументы командной строки. Если вы хотите использовать аргументы командной строки при запуске отладки, необходимо выбрать действие "Пуск ", отличное от запуска проекта.
Управление исходным кодом
Свойства отладки не делятся несколькими пользователями в системе управления исходным кодом. Проекты Visual Basic и C# хранят свойства отладки в пользовательском файле (ProjectName.vbproj.user или ProjectName.csproj.user), и этот файл не находится под системой контроля версий. Если выполняется отладка нескольких пользователей, каждый пользователь должен ввести свойства отладки вручную.
Отладка кэшированных наборов данных в проекте уровня документа
Каждый раз при создании проекта набор данных очищается и воссоздается. Если вы хотите выполнить отладку кэшированного набора данных, необходимо открыть документ за пределами Visual Studio, а затем подключить отладчик.
Отладка проектов документов Word на основе формата документа Word 97-2003 (*.doc)
Чтобы выполнить отладку проекта Word Document на основе формата документа Word 97-2003 (/.doc*), необходимо добавить папку проекта в список доверенных папок. Дополнительные сведения о том, как это сделать, см. в разделе "Предоставление доверия документам".
Отладка отключенных надстроек
Приложения Microsoft Office могут отключать надстройки VSTO, которые ведут себя неожиданно. Приложение 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 Tools для Office создает файл журнала в папке, содержащей манифест развертывания надстройки VSTO, или в папке, содержащей документ или книгу, связанную с настройкой. Если это не удается, среда выполнения Visual Studio Tools для Office создает файл журнала в локальной папке %TEMP% . Для надстроек VSTO на уровне приложения имя по умолчанию — название надстройки.vsto.log. Для проектов уровня документа имя файла журнала — имя документа.расширение.log, например ExcelWorkbook1.xlsx.log. Чтобы остановить ведение журнала ошибок, удалите переменную среды или задайте для нее значение 0 (ноль).