Пошаговое руководство. Создание первой надстройки VSTO для проекта

  • Статья

В этом пошаговом руководстве показано, как создать надстройку VSTO для Проекта Microsoft Office. Функции, создаваемые в таком решении, доступны для самого приложения независимо от того, какие проекты открыты. Дополнительные сведения см. в обзоре разработки решений Office (VSTO).

Область применения. Сведения в этом разделе относятся к проектам надстроек VSTO для Project. Дополнительные сведения см. в разделе "Функции", доступные по Приложение Office ликации и типу проекта.

В этом пошаговом руководстве рассматриваются следующие задачи:

  • создание проекта надстройки VSTO для Project;

  • написание кода, использующего объектную модель Project для добавления задачи в новый проект;

  • Построение и запуск проекта для тестирования.

  • Удаление завершенного проекта для прекращения автоматического запуска надстройки VSTO на компьютере разработчика.

    Примечание.

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

Необходимые компоненты

Для выполнения этого пошагового руководства требуются следующие компоненты:

Создание проекта

Создание проекта в Visual Studio

  1. Запустите среду Visual Studio.

  2. В меню Файл укажите Создать, затем нажмите Проект.

  3. В области шаблонов разверните узел Visual C# или Visual Basic, а затем узел Office/SharePoint.

  4. В развернутом узле Office/SharePoint выберите узел Надстройки Office .

  5. В списке шаблонов проекта выберите шаблон Надстройка Project 2010 или Надстройка Project 2013.

  6. В поле Имя введите FirstProjectAddIn.

  7. Щелкните OK.

    Visual Studio создает проект FirstProjectAddIn и открывает файл кода ThisAddIn в редакторе.

Написание кода, добавляющего новую задачу в проект

Добавьте код в файл кода ThisAddIn. В этом коде для добавления новой задачи в проект используется объектная модель Project. По умолчанию файл кода ThisAddIn содержит следующий созданный код:

  • Частичное определение класса ThisAddIn . Этот класс предоставляет точку входа для кода и обеспечивает доступ к объектной модели Project. Дополнительные сведения см. в разделе "Надстройки VSTO программы". Оставшаяся часть ThisAddIn класса определена в скрытом файле кода, который не следует изменять.

  • Обработчики событий ThisAddIn_Startup и ThisAddIn_Shutdown . Эти обработчики событий вызываются, когда Project загружает и выгружает надстройку VSTO. Их можно использовать для инициализации надстройки VSTO в процессе ее загрузки, а также для освобождения ресурсов, используемых вашей надстройкой VSTO при ее выгрузке. Дополнительные сведения см. в разделе "События" в проектах Office.

Добавление задачи в новый проект

  1. В файл кода ThisAddIn добавьте в класс ThisAddIn указанный ниже код. В коде определяется обработчик события NewProject класса Microsoft.Office.Interop.MSProject.Application.

    Когда пользователь создает проект, этот обработчик событий добавляет в него задачу.

    void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj)
{
    MSProject.Task newTask = pj.Tasks.Add
        ("This text was added by using code", missing);
    newTask.Start = DateTime.Now;
    newTask.Duration = "3";
    newTask.ResourceNames = "Rob Caron, Kelly Krout";
}

    Для изменения проекта в этом примере кода используются следующие объекты:

  • Поле Application класса ThisAddIn . Поле Application возвращает Microsoft.Office.Interop.MSProject.Application объект, представляющий текущий экземпляр Project.

  • Параметр pj обработчика событий для события NewProject. Параметр pj — это объект Microsoft.Office.Interop.MSProject.Project, который представляет проект. Дополнительные сведения см. в разделе "Решения project".

  1. Если используется C#, добавьте в обработчик событий ThisAddIn_Startup указанный ниже код. Этот код подключает обработчик событий к событию Application_Newproject NewProject.

    this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);

Тестирование проекта

Во время сборки и выполнения проекта убедитесь в том, что новая задача отображается в новом проекте.

Тестирование проекта

  1. Нажмите клавишу F5 для построения и запуска проекта. Запускается Microsoft Project, и при этом автоматически открывается пустой проект.

    При построении проекта код компилируется в сборку, которая включается в выходную папку сборки для проекта. Visual Studio также создает ряд записей реестра, которые позволяют Project обнаружить и загрузить надстройку VSTO, и настраивает параметры безопасности на компьютере разработчика, разрешая запуск надстройки VSTO. Дополнительные сведения см. в обзоре процесса сборки решений Office.

  2. Убедитесь в том, что новая задача добавлена в пустой проект.

  3. Убедитесь в том, что в поле Имя задачи виден следующий текст:

    Этот текст добавляется с помощью кода.

  4. Закройте Microsoft Project.

Очистка проекта

Завершив разработку проекта, удалите с компьютера сборку надстройки VSTO, записи реестра и параметры безопасности. В противном случае надстройка VSTO будет запускаться при каждом открытии Microsoft Project на компьютере разработчика.

Очистка проекта

  1. В Visual Studio в меню Построение выберите пункт Очистить решение.

Следующие шаги

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

Связанный контент