Share via

Exemplarische Vorgehensweise: Erstellen Sie Ihr erstes VSTO-Add-In für Projekt

  • Artikel

In dieser exemplarischen Vorgehensweise erfahren Sie, wie Sie ein VSTO-Add-In für Microsoft Office Project erstellen. Die Features, die Sie in dieser Art von Projektmappe erstellen, sind für die Anwendung selbst verfügbar. Dabei spielt es keine Rolle, welche Projekte geöffnet sind. Weitere Informationen finden Sie unter Übersicht über die Entwicklung von Office-Lösungen (VSTO).

Gilt für: Die Informationen in diesem Thema betreffen VSTO-Add-in-Projekte für Projekt. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Erstellen eines VSTO-Add-In-Projekts für Project.

  • Schreiben von Code, der das Objektmodell von Project verwendet, um eine Aufgabe zu einem neuen Projekt hinzuzufügen.

  • Erstellen Sie das Projekt, und führen Sie es aus, um es zu testen.

  • Bereinigen des abgeschlossenen Projekts, damit das VSTO-Add-In nicht mehr automatisch auf Ihrem Entwicklungscomputer ausgeführt wird.

    Hinweis

    Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren der IDE.

Voraussetzungen

Zum Abschließen dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen eines Projekts

So erstellen Sie ein neues Projekt in Visual Studio

  1. Starten Sie Visual Studio.

  2. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  3. Erweitern Sie im Vorlagenbereich Visual C# oder Visual Basicund dann Office/SharePoint.

  4. Wählen Sie unter dem erweiterten Knoten Office/SharePoint den Knoten Office-Add-Ins aus.

  5. Wählen Sie in der Liste mit den Projektvorlagen Project 2010-Add-In oder Project 2013-Add-Inaus.

  6. Geben Sie im Feld Name den Text FirstProjectAddInein.

  7. Klicken Sie auf OK.

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

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

Als Nächstes fügen Sie der Codedatei „ThisAddIn“ Code hinzu. Der neue Code verwendet das Objektmodell von Project, um eine neue Aufgabe zu einem Projekt hinzuzufügen. Standardmäßig enthält die Codedatei „ThisAddIn“ den folgenden generierten Code:

  • Eine Teildefinition der ThisAddIn -Klasse. Diese Klasse stellt einen Einstiegspunkt für Ihren Code bereit und ermöglicht den Zugriff auf das Objektmodell von Project. Weitere Informationen finden Sie unter Programm-VSTO-Add-Ins. Der Rest der ThisAddIn-Klasse ist in einer versteckten Codedatei definiert, die Sie nicht ändern sollten.

  • Die Ereignishandler ThisAddIn_Startup und ThisAddIn_Shutdown . Diese Ereignishandler werden aufgerufen, wenn Ihr VSTO-Add-In von Project geladen und entladen wird. Verwenden Sie diese Ereignishandler zum Initialisieren des VSTO-Add-Ins, wenn es geladen wird, und zum Bereinigen der vom VSTO-Add-In verwendeten Ressourcen, wenn es entladen wird. Weitere Informationen finden Sie unter Events in Office-Projekten.

So fügen Sie eine Aufgabe zu einem neuen Projekt hinzu

  1. Fügen Sie in der Codedatei „ThisAddIn“ der ThisAddIn -Klasse den 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 eine Aufgabe zum Projekt hinzu.

    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 Feld Application der ThisAddIn -Klasse. Das Feld Application gibt ein Microsoft.Office.Interop.MSProject.Application-Objekt zurück, das für die aktuelle Instanz von Project steht.

  • 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 Projektlösungen.

  1. Wenn Sie C# verwenden, fügen Sie dem ThisAddIn_Startup -Ereignishandler den folgenden Code hinzu. Dieser Code wird verwendet, um den Application_Newproject-Ereignishandler mit dem NewProject-Ereignis zu verbinden.

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

Testen des Projekts

Wenn Sie das Projekt erstellen und ausführen, stellen Sie sicher, dass die neue Aufgabe in dem sich ergebenden neuen Projekt angezeigt wird.

So testen Sie das Projekt

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

    Wenn Sie das Projekt erstellen, wird der Code in eine Assembly kompiliert, die im Buildausgabeordner des Projekts enthalten ist. Visual Studio erstellt auch einen Satz von Registrierungseinträgen, mit deren Hilfe Project das VSTO-Add-In ermitteln und laden kann. Die Sicherheitseinstellungen auf dem Entwicklungscomputer werden so konfiguriert, dass das VSTO-Add-In ausgeführt werden kann. Weitere Informationen finden Sie unter Office Solution Build Process Overview.

  2. Stellen Sie sicher, dass dem leeren Projekt eine neue Aufgabe hinzugefügt wird.

  3. Stellen Sie sicher, dass der folgende Text im Feld Aufgabenname der Aufgabe angezeigte.

    Dieser Text wurde per Code hinzugefügt.

  4. Schließen Sie Microsoft Project.

Bereinigen Sie das Projekt

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

So bereinigen Sie das Projekt

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

Nächste Schritte

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

Zugehöriger Inhalt