Поделиться через


Пошаговое руководство. Отладка проекта надстройки

В данном пошаговом руководстве показано создание простого проекта Visual Studio и использование точек останова для отладки проекта.Дополнительные сведения см. в разделе Breakpoints and Tracepoints.

Надстройки — это скомпилированные приложения, которые используют модель объектов автоматизации Visual Studio для автоматизации интегрированной среды разработки (IDE) или управления ею.Дополнительные сведения см. в разделе Создание надстроек и мастеров.

ПримечаниеПримечание

Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от текущих настроек или выпуска.Эти процедуры были разработаны с обычными параметрами разработки.Чтобы изменить настройки, в меню Сервис выберите команду Импорт и экспортпараметров.Дополнительные сведения см. в разделе Параметры Visual Studio.

Чтобы создать простой проект надстройки Visual Studio

  1. В меню Файл выберите Создать и щелкните Проект.

    Откроется New Project Dialog Box.

  2. В области Типы проектов разверните Другие типы проектов и затем выберите Расширение среды.

  3. В области Шаблоны выберите элемент Надстройка Visual Studio.

  4. В поле Имя введите SimpleAddIn в качестве имени проекта надстройки.Нажмите кнопку ОК.

    Запустится Add-in Wizard.

  5. На странице Добро пожаловать в мастер надстроек нажмите кнопку Далее.

  6. На странице Выбрать язык программирования щелкните Создать надстройку, используя Visual C# и нажмите кнопку Далее.

  7. На странице Выберите ведущее приложение примите значения по умолчанию и нажмите кнопку Далее.

  8. На странице Ввести имя и описание введите "Простая надстройка" в качестве имени надстройки и "Для демонстрации отладки простой надстройки" в качестве описания надстройки.Нажмите кнопку Далее.

  9. На странице Выберите параметры надстроек, установите параметр Да, создать пункт меню "Сервис". Примите остальные параметры по умолчанию.Нажмите кнопку Далее.

  10. На странице Выберите информацию "Справка, О программе" отметьте параметр Да, пусть надстройка содержит диалоговое окно "О программе" и нажмите кнопку Далее.

  11. На странице Сводка нажмите кнопку Готово.

    Мастер надстроек создаст новый проект надстройки и откроет интегрированную среду разработки с фокусом на файле Connect.cs.Это основной класс, содержащий код для надстройки.

  12. В Обозревателе решений щелкните правой кнопкой мыши узел Ссылки и выберите Добавить ссылку, чтобы добавить ссылку на сборку.

    Это позволит использовать типы в пространстве имен System.Windows.Forms.

    Откроется Add Reference Dialog Box.

  13. На вкладке .NET дважды щелкните компонент System.Windows.Forms.dll.

    В окне Обозреватель решений ссылка на пространство имен System.Windows.Forms отображается под узлом Ссылки.

    Это пространство имен содержит код, необходимый для отображения окна сообщения, который использован в следующем примере кода.

  14. Для упрощения использования объекта MessageBox в файле Connect.cs добавьте следующий оператор языка в верхней области SimpleAddIn.

    using System.Windows.Forms;
    
  15. Добавьте в надстройку объект MessageBox, добавивMessageBox.Show("Debugging a Simple Add-in"); в метод Exec в файле Connect.cs:

    public void Exec(string commandName,
       vsCommandExecOption executeOption,
       ref object varIn, ref object varOut, ref bool handled)
    {
       handled = false;
       if(executeOption ==
          vsCommandExecOption.vsCommandExecOptionDoDefault)
       {
          if(commandName == "MyAddin1.Connect.MyAddin1")
          {
             handled = true;
             MessageBox.Show("Debugging a Simple Add-in");
             return;
          }
       }
    }
    
  16. Нажмите кнопку Сохранить все, чтобы сохранить результаты работы.

Чтобы выполнить отладку проекта надстройки Visual Studio

  1. В файле Connect.cs щелкните в поле слева от оператора языка:

    MessageBox.Show("Debugging a Simple Add-in")
    

    Появится красная точка (или точка останова), и текст этой строки будет помечен красным.

  2. В меню Отладка выберите команду Начать отладку.

    Текущий сеанс Visual Studio (сеанс отладчика) потеряет фокус, и откроется отлаживаемая программа в другом экземпляре Visual Studio.

  3. Из отлаживаемой среды IDE Visual Studio откройте меню Сервис.

    Пункт SimpleAddIn находится в верхней части меню.

  4. Чтобы выполнить надстройку, выберите команду SimpleAddIn.

    Приложение остановится на той строке, где была задана точка останова в сеансе отладчика Visual Studio, и стока будет выделена желтым.

  5. Во время сеанса отладчика выберите в меню Отладка команду Шаг с заходом.

    Фокус переместится на отлаживаемую программу.Откроется окно сообщения, указывающее на выполнение надстройки.

  6. Нажмите кнопку , чтобы закрыть окно сообщения.

  7. В сеансе отладчика выберите в меню Отладка команду Продолжить.

    Сеанс отладки Visual Studio снова получит фокус.

  8. Завершите сеанс отладки Visual Studio.

  9. В файле Connect.cs щелкните точку останова, поставленную около оператора MessageBox, чтобы удалить ее из исходного кода.

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

См. также

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

Создание надстроек и мастеров

Справочник по автоматизации и возможностям расширения среды