Exemplarische Vorgehensweise: Erstellen des ersten Add-Ins auf Anwendungsebene für Project

Artikel
02/26/2013

In dieser exemplarischen Vorgehensweise wird erläutert, wie Sie ein Add-In auf Anwendungsebene für Microsoft Office Project erstellen.Die Features, die Sie in dieser Art von Projektmappe erstellen, sind für die Anwendung selbst verfügbar, unabhängig davon, welche Projekte geöffnet sind.Weitere Informationen finden Sie unter Übersicht über die Entwicklung von Office-Projektmappen.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Anwendungsebene für Project 2013 und Project 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

Erstellen eines Project-Add-In-Projekts
Schreiben von Code, der das Objektmodell von Project verwendet, um einem neuen Projekt eine Aufgabe hinzuzufügen
Erstellen und Ausführen des Projekts zum Testen
Bereinigen des abgeschlossenen Projekts, damit das Add-In nicht mehr automatisch auf dem Entwicklungscomputer ausgeführt wird

Hinweis
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

Eine Version von Visual Studio 2012, die die Microsoft Office-Entwicklungstools einschließt. Weitere Informationen finden Sie unter [Konfigurieren eines Computers zum Entwickeln von Office-Lösungen](bb398242\(v=vs.110\).md).

Project 2013 oder Project 2010.

Erstellen des Projekts

So erstellen Sie in Visual Studio ein neues Projekt

Starten Sie Visual Studio.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Erweitern Sie im Vorlagenbereich den Visual C# oder Visual Basic, und erweitern Sie dann Office/SharePoint.
unter dem erweiterten Knoten Office/SharePoint wählen Sie den Knoten Office-Add-Ins aus.
Wählen Sie in der Liste der Projektvorlagen Project 2010-Add-In oder Project 2013-Add-In aus.
Geben Sie im Feld Name die Zeichenfolge FirstProjectAddIn ein.
Klicken Sie auf OK.

Visual Studio erstellt das Projekt FirstProjectAddIn und öffnet die ThisAddIn-Codedatei im Editor.

Schreiben von Code, der einem Projekt eine neue Aufgabe hinzufügt

Fügen Sie anschließend der ThisAddIn-Codedatei Code hinzu.Der neue Code verwendet das Objektmodell von Project, um einem Projekt eine neue Aufgabe hinzuzufügen.Standardmäßig enthält die ThisAddIn-Codedatei den folgenden generierten Code:

Eine partielle Definition der ThisAddIn-Klasse.Diese Klasse liefert einen Einstiegspunkt für den Code und ermöglicht den Zugriff auf das Project-Objektmodell.Weitere Informationen finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.Der Rest der ThisAddIn-Klasse ist in einer ausgeblendeten Codedatei definiert, die Sie nicht ändern sollten.
Der ThisAddIn_Startup-Ereignishandler und der ThisAddIn_Shutdown-Ereignishandler.Diese Ereignishandler werden aufgerufen, wenn das Add-In von Project geladen und entladen wird.Verwenden Sie diese Ereignishandler, um das Add-In zu initialisieren, wenn es geladen wird, und um beim Entladen die Ressourcen zu bereinigen, die vom Add-In verwendet werden.Weitere Informationen finden Sie unter Ereignisse in Office-Projekten.

So fügen Sie einem neuen Projekt eine Aufgabe hinzu

Fügen Sie in der ThisAddIn-Codedatei der ThisAddIn-Klasse folgenden Code hinzu.Dieser Code definiert einen Ereignishandler für das NewProject-Ereignis der Microsoft.Office.Interop.MSProject.Application-Klasse.

Wenn der Benutzer ein neues Projekt erstellt, fügt dieser Ereignishandler dem Projekt eine Aufgabe hinzu.

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";
}

Um das Projekt zu ändern, verwendet dieses Codebeispiel die folgenden Objekte:

Das Application-Feld der ThisAddIn-Klasse.Das Application-Feld gibt ein Microsoft.Office.Interop.MSProject.Application-Objekt zurück, das die aktuelle Instanz von Project darstellt.
Der pj-Parameter des Ereignishandlers für das NewProject-Ereignis.Der pj-Parameter ist ein Microsoft.Office.Interop.MSProject.Project-Objekt, das das Projekt darstellt.Weitere Informationen finden Sie unter Projektmappen.

Wenn Sie C# verwenden, fügen Sie dem ThisAddIn_Startup-Ereignishandler den folgenden Code hinzu:Dieser Code verbindet den Application_Newproject-Ereignishandler mit dem NewProject-Ereignis.
```
this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);
```

Testen des Projekts

Überprüfen Sie, ob die neue Aufgabe beim Erstellen und Ausführen des Projekts im resultierenden neuen Projekt angezeigt wird.

So testen Sie das Projekt

Drücken Sie F5, um das Projekt zu erstellen und auszuführen.Microsoft Project startet und öffnet automatisch ein neues leeres Projekt.

Beim Erstellen des Projekts wird der Code in eine Assembly kompiliert, die in den Buildausgabeordner für das Projekt aufgenommen wird.Visual Studio erstellt auch einen Satz von Registrierungseinträgen, die es Project ermöglichen, das Add-In aufzufinden und zu laden, und konfiguriert die Sicherheitseinstellungen auf dem Entwicklungscomputer, damit das Add-In ausgeführt werden kann.Weitere Informationen finden Sie unter Office Solution Build Process Overview.
Überprüfen Sie, ob dem leeren Projekt eine neue Aufgabe hinzugefügt wurde.
Überprüfen Sie, ob der folgende Text im Feld Aufgabenname der Aufgabe angezeigt wird.

This text was added by using code.
Schließen Sie Microsoft Project.

Bereinigen des Projekts

Wenn Sie die Entwicklung eines Projekts abgeschlossen haben, entfernen Sie die Add-In-Assembly, die Registrierungseinträge und die Sicherheitseinstellungen vom Entwicklungscomputer.Andernfalls wird das Add-In jedes Mal ausgeführt, wenn Sie Microsoft Project auf dem Entwicklungscomputer öffnen.

So bereinigen Sie das Projekt

Klicken Sie in Visual Studio im Menü Erstellen auf Projektmappe bereinigen.

Nächste Schritte

Nachdem Sie nun ein grundlegendes Add-In auf Anwendungsebene für Project erstellt haben, können Sie mehr über die Entwicklung von Add-Ins in den folgenden Themen erfahren:

Allgemeine Programmierungsaufgaben, die Sie in Add-Ins für Project ausführen können: Programmieren von Add-Ins auf Anwendungsebene.
Verwenden des Project-Objektmodells: Projektmappen.
Erstellen und Debuggen von Add-Ins auf Anwendungsebene für Project: Aktualisieren von Office-Projektmappen.
Bereitstellen von Add-Ins auf Anwendungsebene für Project: Bereitstellen einer Office-Projektmappe.