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

Статья
02/20/2013

В данном пошаговом руководстве иллюстрируется порядок создания надстройки уровня приложения для Microsoft Office Project.Функциональные возможности, создаваемые в этом виде решения, доступны самому приложению независимо от типа открываемых проектов.Дополнительные сведения см. в разделе Общие сведения о разработке решений Office.

Применение. Сведения этого раздела применяются к проектам уровня приложения для Project 2013 и Project 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

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

Создание проекта надстройки Project.
Написание кода, использующего объектную модель Project для добавления задачи в новый проект.
Построение и запуск проекта для тестирования.
Удаление завершенного проекта, чтобы надстройка больше не запускалась автоматически на компьютере разработчика.

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

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

Обязательные компоненты

Ниже приведены компоненты, необходимые для выполнения данного пошагового руководства.

Выпуск Visual Studio 2012, включающий инструменты разработчика Microsoft Office. Дополнительные сведения см. в разделе [Настройка компьютера для разработки решений Office](bb398242\(v=vs.110\).md).

Project 2013 или Project 2010.

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

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

Запустите Visual Studio.
В меню Файл последовательно выберите пункты Создать и Проект.
В области шаблонов разверните узел Visual C# или Visual Basic, а затем разверните Office/SharePoint.
В разделе развернуть узел Office/SharePoint выберите узел Добавить- ins office.
В списке шаблонов проекта выберите шаблон Надстройка Project 2010 или Надстройка Project 2013.
В поле Имя введите FirstProjectAddIn.
Нажмите кнопку ОК.

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

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

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

Частичное определение класса ThisAddIn.Этот класс предоставляет точку входа для кода, а также доступ к объектной модели Project.Дополнительные сведения см. в разделе Программирование надстроек уровня приложения.Остальная часть класса ThisAddIn определена в скрытом файле кода, который не подлежит изменению.
Обработчики событий ThisAddIn_Startup и ThisAddIn_Shutdown.Эти обработчики событий вызываются, когда Project загружает и выгружает надстройку.Эти обработчики событий следует использовать для инициализации надстройки при ее загрузке и для освобождения ресурсов, занятых надстройкой, при ее выгрузке.Дополнительные сведения см. в разделе События в проектах Office.

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

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

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

Private Sub Application_NewProject(ByVal pj As Microsoft.Office.Interop.MSProject.Project) Handles Application.NewProject
    Dim newTask As MSProject.Task
    newTask = pj.Tasks.Add _
    ("This text was added by using code")
    newTask.Start = DateTime.Now
    newTask.Duration = "3"
    newTask.ResourceNames = "Rob Caron, Kelly Krout"
End Sub

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.

Если используется C#, следует добавить в обработчик событий ThisAddIn_Startup следующий код.Этот код соединяет обработчик событий Application_Newproject с событием NewProject.
```
this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);
```

Проверка проекта

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

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

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

При построении проекта код компилируется в сборку, которая включается в папку выходных данных построения для проекта.Visual Studio также создает ряд записей реестра, которые позволяют Project открывать и загружать надстройку, и настраивает параметры безопасности на компьютере разработчика, чтобы разрешить выполнение надстройки.Дополнительные сведения см. в разделе Office Solution Build Process Overview.
Убедитесь, что новая задача добавлена в пустой проект.
Убедитесь, что в поле Имя задачи виден следующий текст.

Этот текст добавлен с помощью кода.
Закройте Microsoft Project.

Удаление проекта

По окончании разработки проекта удалите сборку надстройки, записи реестра и параметры безопасности из компьютера разработчика.Иначе эта надстройка будет запускаться всякий раз при открытии Microsoft Project на компьютере разработчика.

Удаление проекта

В меню Visual Studio Построение выберите пункт Удалить решение.

Следующие действия

Теперь, после создания простой надстройки уровня приложения для Project, можно начать более подробное изучение процесса разработки надстроек в следующих разделах:

Общие программные задачи, которые можно выполнять в надстройках для Project: Программирование надстроек уровня приложения.
Использование объектной модели Project: Решения Project.
Построение и отладка надстройки уровня приложения для Project: Построение решений Office.
Развертывание надстроек уровня приложения для Project: Развертывание решения Office.